Kodi ——6 Controls （22）6.22 GroupList Control

6.22 GroupList Control

    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.).
  组列表控制是组控制的一种特殊情况。它是用于将一组控件放置在列表中（水平或垂直），并在列表中处理所有的导航和位置。如果项目数超过了列表的大小，它可以滚动，你可以给它设置滚动条，就像其他的任何容器（列表，面板等）一样。

6.22.1 Example

<control type="grouplist" id="17">
      <description>My first group list control</description>
      <left>80</left>
      <top>60</top>
      <width>250</width>
      <height>300</height>
      <itemgap>10</itemgap>
      <pagecontrol>25</pagecontrol>
      <scrolltime tween="sine" easing="out">200</scrolltime>
      <orientation>vertical</orientation>
      <usecontrolcoords>false</usecontrolcoords>
      <visible>true</visible>
      <onup>2</onup>
      <ondown>3</ondown>
      <onleft>1</onleft>
      <onright>1</onright>
      <align>right</align>
</control>

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

Tag	Description
itemgap	Specifies the gap (in pixels) between controls in the list. Defaults to 5px.
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.
scrolltime	The time (in ms) to scroll from one item to another. By default, this is 200ms. The list will scroll smoothly from one item to another as needed. Set it to zero to disable the smooth scrolling. The scroll movement can be further adjusted by selecting one of the available tween methods.
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.
align	Specifies how to align the grouplist. possible values: left, right, center, justify. defaults to left.