Page tree

Search


    Recently Updated



    Latest Releases

 MediaPortal 1 1.15.0
            Releasenews | Download
 MediaPortal 2.1 Pre2 
            Releasenews | Download

Table of Contents

Description

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

Changelog

Change

Date

Version

SelectButton texture size

2012/09/26

1.2.0 to 1.3.0

Text Padding

2013/01/27

1.2.0 to 1.3.0

Shadow text

2010/10/10

1.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>

   

 

This page has no comments.