MultiSelect Control

From DevWiki

Jump to: navigation, search

Applications,Boxee GUI API,Controls

Contents


Overview

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.


Example

  1. <control type="multiselect" id="13">
  2.    <description>My first multiselect control</description>
  3.    <posx>80</posx>
  4.    <posy>60</posy>
  5.    <width>250</width>
  6.    <height>200</height>
  7.    <visible>true</visible>
  8.    <texturefocus>myfocustexture.png</texturefocus>
  9.    <texturenofocus>mynormaltexture.png</texturenofocus>
  10.    <label>Run [ONCLICK ActivateWindow(100)]Test1[/ONCLICK] or [ONCLICK ActivateWindow(101)]Test2[/ONCLICK]...</label>
  11.    <font>font18</font>
  12.    <textcolor>FF000000</textcolor>
  13.    <disabledcolor>80FFFFFF</disabledcolor>
  14.    <aligny>center</aligny>
  15.    <textoffsetx></textoffsetx>
  16.    <textoffsety></textoffsety>
  17.    <onup>2</onup>
  18.    <ondown>3</ondown>
  19.    <onleft>1</onleft>
  20.    <onright>1</onright>
  21. </control>


Available Tags

In addition to the Default Control Properties the following tags are available. Note that all XML tags are in lower case.

Element Description Required
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. No
texturenofocus Specifies the image file which should be displayed behind any selectable text. No
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. No
font Font used for the button label. From fonts.xml. No
textcolor Color used for displaying the standard label. In AARRGGBB hex format, or a name from the color theme. No
focusedcolor Color used for the selected text when an item has focus. In AARRGGBB hex format or a name from the color theme. No
disabledcolor Color used for the text when the control is disabled. In AARRGGBB hex format or a name from the color theme. No
shadowcolor Specifies the color of the drop shadow on the text, in AARRGGBB format, or a name from the color theme. No
aligny Label vertical alignment. Defaults to top, can also be center. No
textoffsetx Amount to offset the highlight textures from the left and right edges of the selectable text. No
textoffsety Amount to offset the label from the top edge of the control when using top alignment. No
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox