Description
A button that allows choosing from a range of different values by toggling throw them.
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 |
| 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 |
| 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 |
| 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 |
| 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>
News & Blogs