Kodi Development  20.0
for Binary and Script based Add-Ons
Subclass - WindowDialogXML

Detailed Description

GUI xml window dialog

Class: xbmcgui.WindowXMLDialog(xmlFilename, scriptPath[, defaultSkin, defaultRes])

Creates a new xml file based window dialog class.

Parameters
xmlFilenamestring - the name of the xml file to look for.
scriptPathstring - path to script. used to fallback to if the xml doesn't exist in the current skin. (eg xbmcaddon.Addon().getAddonInfo('path'))
defaultSkin[opt] string - name of the folder in the skins path to look in for the xml. (default='Default')
defaultRes[opt] string - default skins resolution. (1080i, 720p, ntsc16x9, ntsc, pal16x9 or pal. default='720p')
Exceptions
Exceptionif more then 200 windows are created.
Note
Skin folder structure is e.g. resources/skins/Default/720p

Example:

..
dialog = xbmcgui.WindowXMLDialog('script-Lyrics-main.xml', xbmcaddon.Addon().getAddonInfo('path'), 'default', '1080i')
dialog.doModal()
del dialog
..

On functions defined input variable controlId (GUI control identifier) is the on window.xml defined value behind type added with id="..." and used to identify for changes there and on callbacks.

<control type="label" id="31">
<description>Title Label</description>
...
</control>
<control type="progress" id="32">
<description>progress control</description>
...
</control>