Multiselect control

From XBMC4Xbox
Jump to navigation Jump to search

The multiselect control is used for creating a single line of text with multiple selectable pieces of text that can perform various actions. You can choose the position, size, and look of the text and highlights as well as choosing what action(s) should be performed when items are selected. The multiselect control can also be used inside list containers.

Example

<control type="multiselect" id="13">
      <description>My first multiselect control</description>
      <posx>80</posx>
      <posy>60</posy>
      <width>250</width>
      <height>200</height>
      <visible>true</visible>
      <texturefocus>myfocustexture.png</texturefocus>
      <texturenofocus>mynormaltexture.png</texturenofocus>
      <label>[ONCLICK Shutdown]Shutdown[/ONCLICK] or [ONCLICK Reboot]Reboot[/ONCLICK] XBMC</label>
      <font>font12</font>
      <textcolor>FFFFFFFF</textcolor>
      <disabledcolor>80FFFFFF</disabledcolor>
      <aligny>center</aligny>
      <textoffsetx></textoffsetx>
      <textoffsety></textoffsety>
      <onup>2</onup>
      <ondown>3</ondown>
      <onleft>1</onleft>
      <onright>1</onright>
</control>

Available Tags

In addition to the Default Control Tags the following tags are available. Note that each tag is lower case only. This is important, as xml tags are case-sensitive.

texturefocus

Specifies the image file which should be displayed when a selectable item has focus. It is sized to fit the text, and <textoffsetx> and <textoffsety> are used to space out around the text. See here for additional information about textures.

texturenofocus Specifies the image file which should be displayed behind any selectable text.
label The label used. Selectable text is surrounded in [ONCLICK action]text[/ONCLICK] blocks. You can use the full label formatting syntax as well as info labels.
font Font used for the button label. From fonts.xml.
textcolor Color used for displaying the standard label. In AARRGGBB hex format, or a name from the colour theme.
focusedcolor Color used for the selected text when an item has focus. In AARRGGBB hex format or a name from the colour theme.
disabledcolor Color used for the text when the control is disabled. In AARRGGBB hex format or a name from the colour theme.
shadowcolor Specifies the color of the drop shadow on the text, in AARRGGBB format, or a name from the colour theme.
aligny Label vertical alignment. Defaults to top, can also be center.
textoffsetx Amount to offset the highlight textures from the left and right edges of the selectable text.
textoffsety Amount to offset the label from the top edge of the control when using top alignment.