xbmc
Classes
Subclass - ControlList

**Used for a scrolling lists of items. More...

Collaboration diagram for Subclass - ControlList:

Classes

class  XBMCAddon::xbmcgui::ControlList
 

Detailed Description

**Used for a scrolling lists of items.

Replaces the list control.**

{ ControlList(x, y, width, height[, font, textColor, buttonTexture, buttonFocusTexture, selectedColor, imageWidth, imageHeight, itemTextXOffset, itemTextYOffset, itemHeight, space, alignmentY, shadowColor]) }

The list container is one of several containers used to display items from file lists in various ways. The list container is very flexible - it's only restriction is that it is a list - i.e. a single column or row of items. The layout of the items is very flexible and is up to the skinner.

Note
This class include also all calls from Control
Parameters
xinteger - x coordinate of control.
yinteger - y coordinate of control.
widthinteger - width of control.
heightinteger - height of control.
font[opt] string - font used for items label. (e.g. 'font13')
textColor[opt] hexstring - color of items label. (e.g. '0xFFFFFFFF')
buttonTexture[opt] string - filename for focus texture.
buttonFocusTexture[opt] string - filename for no focus texture.
selectedColor[opt] integer - x offset of label.
imageWidth[opt] integer - width of items icon or thumbnail.
imageHeight[opt] integer - height of items icon or thumbnail.
itemTextXOffset[opt] integer - x offset of items label.
itemTextYOffset[opt] integer - y offset of items label.
itemHeight[opt] integer - height of items.
space[opt] integer - space between items.
alignmentY[opt] integer - Y-axis alignment of items label
  • Flags for alignment used as bits to have several together:
    Definition name Bitflag Description
    XBFONT_LEFT 0x00000000 Align X left
    XBFONT_RIGHT 0x00000001 Align X right
    XBFONT_CENTER_X 0x00000002 Align X center
    XBFONT_CENTER_Y 0x00000004 Align Y center
    XBFONT_TRUNCATED 0x00000008 Truncated text
    XBFONT_JUSTIFIED 0x00000010 Justify text
    XBFONT_TRUNCATED_LEFT 0x00000020 Truncated text from left
shadowColor[opt] hexstring - color of items label's shadow. (e.g. '0xFF000000')
Note
You can use the above as keywords for arguments and skip certain optional arguments.
Once you use a keyword, all following arguments require the keyword.
After you create the control, you need to add it to the window with addControl().

Example:

...
self.cList = xbmcgui.ControlList(100, 250, 200, 250, 'font14', space=5)
...