DialogAddonSettings.xml

DialogAddonSettings.xml is used to provide skins a way to let users change settings exposed by an XMBC addon. It is normally accessed by a user either selecting "Addon Settings" from a context menu, or from a "Settings" button from "DialogAddonSettings.xml".

As addons may provide a wide variety of categories and settings within each category, XBMC exposes these through two GroupLists which it will automatically populates. A GroupList with the id "9" will be populated with the different categories of settings the addon exposes, whilst the GroupList with the id "2" will be populated with the controls for the settings for the currently selected category.

The skin designer may additionally configure the appearance of the various controls that may appear within these GroupLists by defining the "Optional Controls". Otherwise these will be defined by defaults.xml.

Control Settings Area
Grouplist - ID 2

This is the GroupList that will contain the individual settings available for the selected category of the plugin.

This control will normally be paired with a scrollbar control, to provide paging.

Control Section Area
Grouplist - ID 9

This is a GroupList that will contain controls for each category that the add-on exposes settings for.

'OK' Button - ID 10
Selecting this button will save any changes the user has made to the addons settings, and close the dialog.

'Cancel' Button - ID 11
Selecting this button will close the addon settings dialog, without saving any changes.

'Defaults' Button - ID 12
Selecting this button will load the default settings for this dialog.

Heading Label - ID 20
A label to be used as a header for the dialog. This will be automatically formatted by XBMC as "{Addon Name} - Settings"

Optional Controls
If desired, default settings and appearances for the controls used in this dialog can be set for the various controls that may appear in the GroupLists. If these are omitted, controls will default to values set in defaults.xml.

Button - ID 3
Default settings for buttons in the GroupLists

RadioButton - ID4
Default settings for radio buttons in the GroupLists

SpinControlex - ID 5
Default settings and appearance for spin controls in the GroupLists

Separator Image - ID 6
Default settings and appearance for an image to act as a separator between items in the GroupList with ID 2.

Label - ID 7
Default settings and appearance for labels in the GroupLists

Sliderex - ID 8
Default settings and appearance for a slide in the GroupLists

Button - ID 13
Default settings and appearance for a button in the GroupLists