DialogProgressBG

Kodi's background progress dialog class More...

Classes
class	XBMCAddon::xbmcgui::DialogProgressBG

Functions
	XBMCAddon::xbmcgui::Dialog::Dialog ()=default
	XBMCAddon::xbmcgui::Dialog::~Dialog () override
void	XBMCAddon::xbmcgui::DialogProgress::deallocating () override
	XBMCAddon::xbmcgui::DialogProgress::DialogProgress ()=default
	XBMCAddon::xbmcgui::DialogProgress::~DialogProgress () override
void	XBMCAddon::xbmcgui::DialogBusy::deallocating () override
	XBMCAddon::xbmcgui::DialogBusy::DialogBusy ()
	XBMCAddon::xbmcgui::DialogBusy::~DialogBusy () override
void	XBMCAddon::xbmcgui::DialogProgressBG::deallocating () override
	XBMCAddon::xbmcgui::DialogProgressBG::DialogProgressBG ()=default
	XBMCAddon::xbmcgui::DialogProgressBG::~DialogProgressBG () override
	XBMCAddon::xbmcgui::DialogProgressBG::create (...)
	XBMCAddon::xbmcgui::DialogProgressBG::update (...)
	XBMCAddon::xbmcgui::DialogProgressBG::close (...)
	XBMCAddon::xbmcgui::DialogProgressBG::isFinished (...)

Detailed Description

Kodi's background progress dialog class

Function Documentation

close()

void XBMCAddon::xbmcgui::DialogProgressBG::close

(

...

)

\htmlonly <h4><code><span style="font-style: italic;">Function: </span><span style="font-style: bold;"><font color=31363b><big> xbmcgui.DialogProgressBG().close() </big></font></span></code></h4> \endhtmlonly

Close the background progress dialog

---

Example:

..
pDialog.close()
..

create()

void XBMCAddon::xbmcgui::DialogProgressBG::create

(

...

)

\htmlonly <h4><code><span style="font-style: italic;">Function: </span><span style="font-style: bold;"><font color=31363b><big> xbmcgui.DialogProgressBG().create(heading[, message]) </big></font></span></code></h4> \endhtmlonly

Create and show a background progress dialog.

Parameters

heading	string or unicode - dialog heading.
message	[opt] string or unicode - message text.

Note

'heading' is used for the dialog's id. Use a unique heading. Use update() to update heading, message and progressbar.

---

Example:

..
pDialog = xbmcgui.DialogProgressBG()
pDialog.create('Movie Trailers', 'Downloading Monsters Inc... .')
..

deallocating() [1/3]

void XBMCAddon::xbmcgui::DialogProgress::deallocating ( )

overrideprotectedvirtual

This method is meant to be called from the destructor of the lowest level class.

It's virtual because it's a convenient place to receive messages that we're about to go be deleted but prior to any real tear-down.

Any overloading classes need to remember to pass the call up the chain.

Reimplemented from XBMCAddon::AddonClass.

deallocating() [2/3]

void XBMCAddon::xbmcgui::DialogBusy::deallocating ( )

overrideprotectedvirtual

This method is meant to be called from the destructor of the lowest level class.

It's virtual because it's a convenient place to receive messages that we're about to go be deleted but prior to any real tear-down.

Any overloading classes need to remember to pass the call up the chain.

Reimplemented from XBMCAddon::AddonClass.

deallocating() [3/3]

void XBMCAddon::xbmcgui::DialogProgressBG::deallocating ( )

overrideprotectedvirtual

This method is meant to be called from the destructor of the lowest level class.

It's virtual because it's a convenient place to receive messages that we're about to go be deleted but prior to any real tear-down.

Any overloading classes need to remember to pass the call up the chain.

Reimplemented from XBMCAddon::AddonClass.

Dialog()

XBMCAddon::xbmcgui::Dialog::Dialog ( )

inlinedefault

DialogBusy()

XBMCAddon::xbmcgui::DialogBusy::DialogBusy ( )

inline

DialogProgress()

XBMCAddon::xbmcgui::DialogProgress::DialogProgress ( )

default

DialogProgressBG()

XBMCAddon::xbmcgui::DialogProgressBG::DialogProgressBG ( )

default

isFinished()

bool XBMCAddon::xbmcgui::DialogProgressBG::isFinished

(

...

)

\htmlonly <h4><code><span style="font-style: italic;">Function: </span><span style="font-style: bold;"><font color=31363b><big> xbmcgui.DialogProgressBG().isFinished() </big></font></span></code></h4> \endhtmlonly

Checks progress is finished

Returns

True if the background dialog is active.

---

Example:

..
if (pDialog.isFinished()): return
..

update()

void XBMCAddon::xbmcgui::DialogProgressBG::update

(

...

)

\htmlonly <h4><code><span style="font-style: italic;">Function: </span><span style="font-style: bold;"><font color=31363b><big> xbmcgui.DialogProgressBG().update([percent, heading, message]) </big></font></span></code></h4> \endhtmlonly

Updates the background progress dialog.

Parameters

percent	[opt] integer - percent complete. (0:100)
heading	[opt] string or unicode - dialog heading.
message	[opt] string or unicode - message text.

Note

To clear heading or message, you must pass a blank character.

---

Example:

..
pDialog.update(25, message='Downloading Finding Nemo ...')
..

~Dialog()

XBMCAddon::xbmcgui::Dialog::~Dialog ( )

overridedefault

~DialogBusy()

XBMCAddon::xbmcgui::DialogBusy::~DialogBusy ( )

override

~DialogProgress()

XBMCAddon::xbmcgui::DialogProgress::~DialogProgress ( )

override

~DialogProgressBG()

XBMCAddon::xbmcgui::DialogProgressBG::~DialogProgressBG ( )

override