\cpp_class{ kodi::gui::CWindow } Main window control class More...

Modules
	Definitions, structures and enumerators
	Library definition values

	Callback functions from Kodi to add-on

Functions
	kodi::gui::CWindow::CWindow (const std::string &xmlFilename, const std::string &defaultSkin, bool asDialog, bool isMedia=false)
	Class constructor with needed values for window / dialog. More...

bool	kodi::gui::CWindow::Show ()
	Show this window. More...

void	kodi::gui::CWindow::Close ()
	Closes this window. More...

void	kodi::gui::CWindow::DoModal ()
	Display this window until close() is called. More...

bool	kodi::gui::CWindow::SetFocusId (int iControlId)
	Gives the control with the supplied focus. More...

int	kodi::gui::CWindow::GetFocusId ()
	Returns the id of the control which is focused. More...

void	kodi::gui::CWindow::SetControlLabel (int controlId, const std::string &label)
	To set the used label on given control id. More...

void	kodi::gui::CWindow::SetProperty (const std::string &key, const std::string &value)
	Sets a window property, similar to an infolabel. More...

std::string	kodi::gui::CWindow::GetProperty (const std::string &key) const
	Returns a window property as a string, similar to an infolabel. More...

void	kodi::gui::CWindow::SetPropertyInt (const std::string &key, int value)
	Sets a window property with integer value. More...

int	kodi::gui::CWindow::GetPropertyInt (const std::string &key) const
	Returns a window property with integer value. More...

void	kodi::gui::CWindow::SetPropertyBool (const std::string &key, bool value)
	Sets a window property with boolean value. More...

bool	kodi::gui::CWindow::GetPropertyBool (const std::string &key) const
	Returns a window property with boolean value. More...

void	kodi::gui::CWindow::SetPropertyDouble (const std::string &key, double value)
	Sets a window property with double value. More...

double	kodi::gui::CWindow::GetPropertyDouble (const std::string &key) const
	Returns a window property with double value. More...

void	kodi::gui::CWindow::ClearProperties ()
	Remove all present properties from window. More...

void	kodi::gui::CWindow::ClearProperty (const std::string &key)
	Clears the specific window property. More...

void	kodi::gui::CWindow::ClearList ()
	Function delete all entries in integrated list. More...

void	kodi::gui::CWindow::AddListItem (ListItemPtr item, int itemPosition=-1)
	To add a list item in the on window integrated list. More...

void	kodi::gui::CWindow::AddListItem (const std::string item, int itemPosition=-1)
	To add a list item based upon string in the on window integrated list. More...

void	kodi::gui::CWindow::RemoveListItem (int itemPosition)
	Remove list item on position. More...

void	kodi::gui::CWindow::RemoveListItem (ListItemPtr item)
	Remove item with given control class from list. More...

ListItemPtr	kodi::gui::CWindow::GetListItem (int listPos)
	To get list item control class on wanted position. More...

void	kodi::gui::CWindow::SetCurrentListPosition (int listPos)
	To set position of selected part in list. More...

int	kodi::gui::CWindow::GetCurrentListPosition ()
	To get current selected position in list. More...

int	kodi::gui::CWindow::GetListSize ()
	To get the amount of entries in the list. More...

void	kodi::gui::CWindow::SetContainerProperty (const std::string &key, const std::string &value)
	Sets a container property, similar to an infolabel. More...

void	kodi::gui::CWindow::SetContainerContent (const std::string &value)
	Sets the content type of the container. More...

int	kodi::gui::CWindow::GetCurrentContainerId ()
	Get the id of the currently visible container. More...

void	kodi::gui::CWindow::MarkDirtyRegion ()
	To inform Kodi that it need to render region new. More...

Detailed Description

\cpp_class{ kodi::gui::CWindow } Main window control class

The with #include <kodi/gui/Window.h> included file brings support to create a window or dialog on Kodi.

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>

Function Documentation

◆ AddListItem() [1/2]

void kodi::gui::CWindow::AddListItem	(	const std::string	item,
		int	itemPosition = `-1`
	)

inline

To add a list item based upon string in the on window integrated list.

Parameters

[in]	item	List item to add
[in]	itemPosition	[opt] The position for item, default is on end

◆ AddListItem() [2/2]

void kodi::gui::CWindow::AddListItem	(	ListItemPtr	item,
		int	itemPosition = `-1`
	)

inline

To add a list item in the on window integrated list.

Parameters

[in]	item	List item to add
[in]	itemPosition	[opt] The position for item, default is on end

◆ ClearList()

void kodi::gui::CWindow::ClearList ( )

inline

Function delete all entries in integrated list.

◆ ClearProperties()

void kodi::gui::CWindow::ClearProperties ( )

inline

Remove all present properties from window.

◆ ClearProperty()

void kodi::gui::CWindow::ClearProperty ( const std::string & key )

inline

Clears the specific window property.

Parameters

[in] key string - property name.

Note: Key is NOT case sensitive. Equivalent to SetProperty(key, "") You can use the above as keywords for arguments and skip certain optional arguments. Once you use a keyword, all following arguments require the keyword.

Example:

..
ClearProperty('Category')
..

◆ Close()

void kodi::gui::CWindow::Close ( )

inline

Closes this window.

Closes this window by activating the old window.

Note: The window is not deleted with this method.

◆ CWindow()

kodi::gui::CWindow::CWindow	(	const std::string &	xmlFilename,
		const std::string &	defaultSkin,
		bool	asDialog,
		bool	isMedia = `false`
	)

inline

Class constructor with needed values for window / dialog.

Creates a new Window class.

Parameters

[in]	xmlFilename	XML file for the skin
[in]	defaultSkin	default skin to use if needed not available
[in]	asDialog	Use window as dialog if set
[in]	isMedia	[opt] bool - if False, create a regular window. if True, create a mediawindow. (default=false)

Note: only usable for windows not for dialogs.

◆ DoModal()

void kodi::gui::CWindow::DoModal ( )

inline

Display this window until close() is called.

◆ GetCurrentContainerId()

int kodi::gui::CWindow::GetCurrentContainerId ( )

inline

Get the id of the currently visible container.

Returns: currently visible container id

◆ GetCurrentListPosition()

int kodi::gui::CWindow::GetCurrentListPosition ( )

inline

To get current selected position in list.

Returns: Current list position

◆ GetFocusId()

int kodi::gui::CWindow::GetFocusId ( )

inline

Returns the id of the control which is focused.

Returns: Focused control id

◆ GetListItem()

ListItemPtr kodi::gui::CWindow::GetListItem ( int listPos )

inline

To get list item control class on wanted position.

Parameters

[in] listPos Position from where control is needed

Returns: The list item control class or null if not found

Warning: Function returns a new generated CListItem class!

◆ GetListSize()

int kodi::gui::CWindow::GetListSize ( )

inline

To get the amount of entries in the list.

Returns: Size of in window integrated control class

◆ GetProperty()

std::string kodi::gui::CWindow::GetProperty ( const std::string & key ) const

inline

Returns a window property as a string, similar to an infolabel.

Parameters

[in] key string - property name.

Returns: The property as strin (if present)

Note: Key is NOT case sensitive. Setting value to an empty string is equivalent to clearProperty(key).
You can use the above as keywords for arguments and skip certain optional arguments.
Once you use a keyword, all following arguments require the keyword.

◆ GetPropertyBool()

bool kodi::gui::CWindow::GetPropertyBool ( const std::string & key ) const

inline

Returns a window property with boolean value.

Parameters

[in] key string - property name.

Returns: boolean value of property

◆ GetPropertyDouble()

double kodi::gui::CWindow::GetPropertyDouble ( const std::string & key ) const

inline

Returns a window property with double value.

Parameters

[in] key string - property name.

Returns: double value of property

◆ GetPropertyInt()

int kodi::gui::CWindow::GetPropertyInt ( const std::string & key ) const

inline

Returns a window property with integer value.

Parameters

[in] key string - property name.

Returns: integer value of property

◆ MarkDirtyRegion()

void kodi::gui::CWindow::MarkDirtyRegion ( )

inline

To inform Kodi that it need to render region new.

◆ RemoveListItem() [1/2]

void kodi::gui::CWindow::RemoveListItem ( int itemPosition )

inline

Remove list item on position.

Parameters

[in] itemPosition List position to remove

◆ RemoveListItem() [2/2]

void kodi::gui::CWindow::RemoveListItem ( ListItemPtr item )

inline

Remove item with given control class from list.

Parameters

[in] item List item control class to remove

◆ SetContainerContent()

void kodi::gui::CWindow::SetContainerContent ( const std::string & value )

inline

Sets the content type of the container.

Parameters

[in] value string or unicode - content value.

Available content types

Name	Media
actors	Videos
addons	Addons, Music, Pictures, Programs, Videos
albums	Music, Videos
artists	Music, Videos
countries	Music, Videos
directors	Videos
files	Music, Videos
games	Games
genres	Music, Videos
images	Pictures
mixed	Music, Videos
movies	Videos
Musicvideos	Music, Videos
playlists	Music, Videos
seasons	Videos
sets	Videos
songs	Music
studios	Music, Videos
tags	Music, Videos
tvshows	Videos
videos	Videos
years	Music, Videos

◆ SetContainerProperty()

void kodi::gui::CWindow::SetContainerProperty	(	const std::string &	key,
		const std::string &	value
	)

inline

Sets a container property, similar to an infolabel.

Parameters

[in]	key	string - property name.
[in]	value	string or unicode - value of property.

Note: Key is NOT case sensitive.
You can use the above as keywords for arguments and skip certain optional arguments.
Once you use a keyword, all following arguments require the keyword.

◆ SetControlLabel()

void kodi::gui::CWindow::SetControlLabel	(	int	controlId,
		const std::string &	label
	)

inline

To set the used label on given control id.

Parameters

[in]	controlId	Control id where label need to set
[in]	label	Label to use

◆ SetCurrentListPosition()

void kodi::gui::CWindow::SetCurrentListPosition ( int listPos )

inline

To set position of selected part in list.

Parameters

[in] listPos Position to use

◆ SetFocusId()

bool kodi::gui::CWindow::SetFocusId ( int iControlId )

inline

Gives the control with the supplied focus.

Parameters

[in] iControlId On skin defined id of control

Returns: Return true if call and focus is successed, if false was something failed to get needed skin parts.

◆ SetProperty()

void kodi::gui::CWindow::SetProperty	(	const std::string &	key,
		const std::string &	value
	)

inline

Sets a window property, similar to an infolabel.

Parameters

[in]	key	string - property name.
[in]	value	string or unicode - value of property.

Note: Key is NOT case sensitive. Setting value to an empty string is equivalent to clearProperty(key).
You can use the above as keywords for arguments and skip certain optional arguments.
Once you use a keyword, all following arguments require the keyword.

◆ SetPropertyBool()

void kodi::gui::CWindow::SetPropertyBool	(	const std::string &	key,
		bool	value
	)

inline

Sets a window property with boolean value.

Parameters

[in]	key	string - property name.
[in]	value	boolean value to set

◆ SetPropertyDouble()

void kodi::gui::CWindow::SetPropertyDouble	(	const std::string &	key,
		double	value
	)

inline

Sets a window property with double value.

Parameters

[in]	key	string - property name.
[in]	value	double value to set

◆ SetPropertyInt()

void kodi::gui::CWindow::SetPropertyInt	(	const std::string &	key,
		int	value
	)

inline

Sets a window property with integer value.

Parameters

[in]	key	string - property name.
[in]	value	integer value to set

◆ Show()

bool kodi::gui::CWindow::Show ( )

inline

Show this window.

Shows this window by activating it, calling close() after it wil activate the current window again.

Note: If your Add-On ends this window will be closed to. To show it forever, make a loop at the end of your Add-On or use doModal() instead.

Warning: If used must be the class be global present until Kodi becomes closed. The creation can be done after before "Show" becomes called, but not delete class after them.

Returns: Return true if call and show is successed, if false was something failed to get needed skin parts.

Modules

Functions

Detailed Description

Function Documentation

◆ AddListItem() [1/2]

◆ AddListItem() [2/2]

◆ ClearList()

◆ ClearProperties()

◆ ClearProperty()

◆ Close()

◆ CWindow()

◆ DoModal()

◆ GetCurrentContainerId()

◆ GetCurrentListPosition()

◆ GetFocusId()

◆ GetListItem()

◆ GetListSize()

◆ GetProperty()

◆ GetPropertyBool()

◆ GetPropertyDouble()

◆ GetPropertyInt()

◆ MarkDirtyRegion()

◆ RemoveListItem() [1/2]

◆ RemoveListItem() [2/2]

◆ SetContainerContent()

◆ SetContainerProperty()

◆ SetControlLabel()

◆ SetCurrentListPosition()

◆ SetFocusId()

◆ SetProperty()

◆ SetPropertyBool()

◆ SetPropertyDouble()

◆ SetPropertyInt()

◆ Show()