Kodi Documentation 22.0
Kodi is an open source media player and entertainment hub.
Loading...
Searching...
No Matches
Game Controller List

Table of Contents

Used to display a list of game controllers, allowing for special effects such as controller highlighting and port selection.

The game controller list is used for displaying a list of game controllers. It is provided as a container to allow for special behavior of the inner game controllers, such as visualizing the current in-game port for each controller in the GameAgents dialog.

The control was introduced in v21 to support the new Player Viewer (GameAgents) dialog.

Example

<control type="gamecontrollerlist">
<description>My first game controller list, showing two items: A "controller disconnected" icon and a SNES controller</description>
<width>192</width>
<height>96</height>
<orientation>horizontal</orientation>
<align>left</align>
<itemlayout width="96" height="96">
<control type="gamecontroller">
<texture>$INFO[ListItem.Icon]</texture>
<controllerid>$INFO[ListItem.Property(controllerid)]</controllerid>
</control>
</itemlayout>
<focusedlayout width="96" height="96">
<control type="gamecontroller">
<texture>$INFO[ListItem.Icon]</texture>
<controllerid>$INFO[ListItem.Property(controllerid)]</controllerid>
</control>
</focusedlayout>
<content>
<item>
<icon>DefaultAddonNone.png</icon>
</item>
<item>
<property name="controllerid">game.controller.snes</property>
</item>
</content>
</control>
A
#define A(x)
Definition WindowXML.cpp:36
name
enum const char * name
Definition addon_base.h:203
left
@ left
Definition cc_decoder708.h:76
height
const char const uint8_t size_t unsigned int unsigned int * height
Definition kodi-dev-kit/include/kodi/c-api/addon-instance/ImageDecoder.h:417
width
const char const uint8_t size_t unsigned int * width
Definition kodi-dev-kit/include/kodi/c-api/addon-instance/ImageDecoder.h:416

Available tags

The default control tags are applicable to this control. Note that each tag is lower case only. This is important, as xml tags are case-sensitive.

The game controller list derives from a List Container, so all list tags and attributes can be used.

In addition, the following game-related tags are available:

Tag Description
align Align controllers to the left or right, depending on how many in-game ports are available. Only used in-game for list item content provided by core, such as in the Player Viewer (GameAgents) dialog. Ignored if static content is provided.
v21 Skinning engine changes:
Game Controller List was added.

See also

Development: