Fork MediaPortal on GitHub
MediaPortal Windows Media Center
MediaPortal Wiki > MediaPortal 1 > Contribute > Skins > Skin Architecture > Skin Controls > Selectbutton

Selectbutton

Was this page helpful?

    Description

    A button that allows choosing from a range of different values by toggling throw them.

    Changelog

    ChangeDateVersion
    SelectButton texture size2012/09/261.2.0 to 1.3.0
    Text Padding2013/01/271.2.0 to 1.3.0
    Shadow text2010/10/101.0.1 to 1.1.0

    Tags

    GUISelectButtonControl (selectbutton)

    Element Name Data Type Description
    textcolor Long Text color when control has focus
    textcolorNoFocus Long Text color when control hasn't got the focus
    disabledcolor Long Text color when control is disabled
    label String Currently shown text
    font String Font used for drawing the text
    textureFocus String Texture when control has focus
    textureNoFocus Integer Texture when control hasn't got the focus
    texturebg String Background texture
    textureLeft String Texture of the "switch to previous" symbol (no focus)
    textureLeftWidth Integer [Since 1.3] Width of textureLeft
    textureLeftHeight Integer [Since 1.3] Height of textureLeft
    textureRight String Texture of the "switch to next" symbol symbol (no focus)
    textureRightWidth Integer [Since 1.3] Width of textureRight
    textureRightHeight Integer [Since 1.3] Height of textureRight
    textureLeftFocus String Texture of the "switch to previous" symbol (has focus)
    textureLeftFocusWidth Integer [Since 1.3] Width of textureLeftFocus
    textureLeftFocusHeight Integer [Since 1.3] Height of textureLeftFocus
    textureRightFocus String Texture of the "switch to next" symbol (has focus)
    textureRightFocusWidth Integer [Since 1.3] Width of textureRightFocus
    textureRightFocusHeight Integer [Since 1.3] Height of textureRightFocus
    textXOff Integer X offset of the text
    textYOff Integer Y offset of the text
    textXOff2 Integer  
    textYOff2 Integer  
    textpadding Integer [Since 1.3] provides "space" inside the label text to prevent overlap with graphics that follow on the right.
    shadowAngle Integer  
    shadowDistance Integer  
    shadowColor Long  
    textalign Alignment Alignment of the text: Left | Right | Center
    onclick String [Since 1.3] Executes a MediaPortal skin function when the button is clicked.  See Skin Settings for more information.

    Inherited by GUIControl

    See GUIControl for the full documentation of this control.

    Element Name Data Type Description
    id Integer The id of the control. The id will couple the skin file to the code, so if we later on want to check that a user pressed a button, the id will be required and must be unique. For controls that will never be referenced in the code it is safe to set it to "1"
    description String An optional description of the control for your reference
    type String The type of the control, for instance "button", "label", "textbox" and all other controls.
    posX Integer The X-position on the window for this control
    posY Integer The Y-position on the window for this control
    width Integer The width of this control
    height Integer The height of this control
    onleft Integer The control id to move the focus to when the user moves left. If not specified (or zero) MediaPortal will find the closest control in that direction to move to. As of v1.7.0 Skin Settings and Skin Expressions are also supported. 
    onright Integer The control id to move the focus to when the user moves right. If not specified (or zero) MediaPortal will find the closest control in that direction to move to. As of v1.7.0 Skin Settings and Skin Expressions are also supported. 
    onup Integer The control id to move the focus to when the user moves up. If not specified (or zero) MediaPortal will find the closest control in that direction to move to. As of v1.7.0 Skin Settings and Skin Expressions are also supported. 
    ondown Integer The control id to move the focus to when the user moves down. If not specified (or zero) MediaPortal will find the closest control in that direction to move to. As of v1.7.0 Skin Settings and Skin Expressions are also supported. 
    colordiffuse Long Allows you to mix a color & a graphics texture. E.g. If you have a graphics texture like a blue button you can mix it with a yellow color diffuse and the end result will be green. Defaults to 0xFFFFFFFF
    dimColor Integer Color for a control when it is not focussed. Defaults to half transparent (0x60ffffff)
    onfocus String [Since 1.3] Executes a MediaPortal skin function when the control gains focus.  See Skin Settings for more information.

    XML Examples

      <control>
        <description>default select button</description>
        <type>selectbutton</type>
        <id>0</id>
        <posX>97</posX>
        <posY>287</posY>
        <width>260</width>
        <height>40</height>
        <label>457</label>
        <textXOff>26</textXOff>
        <textYOff>4</textYOff>
        <textXOff2>17</textXOff2>
        <textYOff2>6</textYOff2>
        <textureFocus>button_focus.png</textureFocus>
        <textureNoFocus>button_nofocus.png</textureNoFocus>
        <texturebg>button_focus.png</texturebg>
        <textureLeft>arrow_round_left_nofocus.png</textureLeft>
        <textureLeftHeight>21</textureLeftHeight>
        <textureLeftWidth>21</textureLeftWidth>
        <textureLeftFocus>arrow_round_left_focus.png</textureLeftFocus>
        <textureLeftFocusHeight>21</textureLeftFocusHeight>
        <textureLeftFocusWidth>21</textureLeftFocusWidth>
        <textureRight>arrow_round_right_nofocus.png</textureRight>
        <textureRightHeight>21</textureRightHeight>
        <textureRightWidth>21</textureRightWidth>
        <textureRightFocus>arrow_round_right_focus.png</textureRightFocus>
        <textureRightFocusHeight>21</textureRightFocusHeight>
        <textureRightFocusWidth>21</textureRightFocusWidth>
        <font>font12</font>
        <textcolor>ffffffff</textcolor>
        <colordiffuse>ffffffff</colordiffuse>
        <disabledcolor>ffffcc00</disabledcolor>
        <textcolorNoFocus>ffa9d0f7</textcolorNoFocus>
        <dimColor>ffcccccc</dimColor>
        <disabledcolor>60ffffff</disabledcolor>
        <animation effect="zoom" start="100,100" end="105,105" time="50">focus</animation>
        <animation effect="zoom" start="105,105" end="100,100" time="50">unfocus</animation>
      </control>
    



    Tag page (Edit tags)
    • No tags
    Running the latest version?

    V1.8.0 - released July 2014
    Releasenews | Download
    Changelog
     | Requirements
    HTPC
    Team-MediaPortal
     
    About
    Contact |  Press
    Partners