Kodi Docs 20.0
Kodi is an open source media player and entertainment hub.
DialogProgress

Kodi's progress dialog class (Duh!) More...

Modules

 DialogProgressBG
 Kodi's background progress dialog class
 

Classes

class  XBMCAddon::xbmcgui::DialogProgress
 

Functions

 XBMCAddon::xbmcgui::DialogProgress::create (...)
 
 XBMCAddon::xbmcgui::DialogProgress::update (...)
 
 XBMCAddon::xbmcgui::DialogProgress::close (...)
 
 XBMCAddon::xbmcgui::DialogProgress::iscanceled (...)
 

Detailed Description

Kodi's progress dialog class (Duh!)

Function Documentation

◆ close()

void XBMCAddon::xbmcgui::DialogProgress::close (   ...)

Function: xbmcgui.DialogProgress().close()


Close the progress dialog.


Example:

..
pDialog.close()
..

◆ create()

void XBMCAddon::xbmcgui::DialogProgress::create (   ...)

Function: xbmcgui.DialogProgress().create(heading[, message])


Create and show a progress dialog.

Parameters
headingstring or unicode - dialog heading.
message[opt] string or unicode - message text.
Note
Use update() to update lines and progressbar.

v19 Python API changes:

Renamed option line1 to message.

Removed option line2.

Removed option line3.

Example:

..
pDialog = xbmcgui.DialogProgress()
pDialog.create('Kodi', 'Initializing script...')
..

◆ iscanceled()

bool XBMCAddon::xbmcgui::DialogProgress::iscanceled (   ...)

Function: xbmcgui.DialogProgress().iscanceled()


Checks progress is canceled.

Returns
True if the user pressed cancel.

Example:

..
if (pDialog.iscanceled()): return
..

◆ update()

void XBMCAddon::xbmcgui::DialogProgress::update (   ...)

Function: xbmcgui.DialogProgress().update(percent[, message])


Updates the progress dialog.

Parameters
percentinteger - percent complete. (0:100)
message[opt] string or unicode - message text.

v19 Python API changes:

Renamed option line1 to message.

Removed option line2.

Removed option line3.

Example:

..
pDialog.update(25, 'Importing modules...')
..