Group List Control

From Official Kodi Wiki
Revision as of 23:58, 24 July 2007 by >Jmarshall (New page: The group list control is a special case of the group control. It is used for placing a set of controls into a list (either horizontally or vertically) and handles all the navigation with...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The group list control is a special case of the group control. It is used for placing a set of controls into a list (either horizontally or vertically) and handles all the navigation within the list and placement within the list for you. It will be scrollable if the number of items exceeds the size of the list, and you can assign a scrollbar to it just like you can to any of the containers (list, panel, etc.).

Example

<xml> <control type="grouplist" id="17">

     <description>My first group list control</description>
     <posx>80</posx>
     <posy>60</posy>
     <width>250</width>
     <height>300</height>
     <itemgap>10</itemgap>
     <pagecontrol>25</pagecontrol>
     <orientation>vertical</orientation>
     <usecontrolcoords>false</usecontrolcoords>
     <visible>true</visible>
     <onup>2</onup>
     <ondown>3</ondown>
     <onleft>1</onleft>
     <onright>1</onright>
     ... more controls go here ...

</control> </xml>

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.

itemgap Specifies the gap (in pixels) between controls in the list.
orientation Specifies whether the list is horizontal or vertical. Defaults to vertical.
pagecontrol Specifies the page control used to scroll up and down the list. Set the page control's id here.
usecontrolcoords Specifies whether the list should use the control's coordinates as an offset location from the coordinates it would normally use to draw the control. Defaults to false. Useful for staggering a control in from the edge of the grouplist, or for having more space around a control than <itemgap> gives.