Kodi Documentation 18.0
Kodi is an open source media player and entertainment hub.
CGUIListItem Class Reference

#include <GUIListItem.h>

Inheritance diagram for CGUIListItem:
CFileItem CFileItemList CGUIStaticItem

Classes

struct  icompare
 

Public Types

enum  GUIIconOverlay {
  ICON_OVERLAY_NONE = 0 , ICON_OVERLAY_RAR , ICON_OVERLAY_ZIP , ICON_OVERLAY_LOCKED ,
  ICON_OVERLAY_UNWATCHED , ICON_OVERLAY_WATCHED , ICON_OVERLAY_HD
}
 
typedef std::map< std::string, std::string > ArtMap
 

Public Member Functions

 CGUIListItem (void)
 
 CGUIListItem (const CGUIListItem &item)
 
 CGUIListItem (const std::string &strLabel)
 
virtual ~CGUIListItem (void)
 
virtual CGUIListItemClone () const
 
CGUIListItemoperator= (const CGUIListItem &item)
 
virtual void SetLabel (const std::string &strLabel)
 
const std::string & GetLabel () const
 
void SetLabel2 (const std::string &strLabel)
 
const std::string & GetLabel2 () const
 
void SetIconImage (const std::string &strIcon)
 
const std::string & GetIconImage () const
 
void SetOverlayImage (GUIIconOverlay icon, bool bOnOff=false)
 
std::string GetOverlayImage () const
 
void SetArt (const std::string &type, const std::string &url)
 Set a particular art type for an item. More...
 
void SetArt (const ArtMap &art)
 set artwork for an item More...
 
void AppendArt (const ArtMap &art, const std::string &prefix="")
 append artwork to an item More...
 
void SetArtFallback (const std::string &from, const std::string &to)
 set a fallback image for art More...
 
void ClearArt ()
 clear art on an item More...
 
std::string GetArt (const std::string &type) const
 Get a particular art type for an item. More...
 
const ArtMapGetArt () const
 get artwork for an item Retrieves artwork in a type:url map More...
 
bool HasArt (const std::string &type) const
 Check whether an item has a particular piece of art Equivalent to !GetArt(type).empty() More...
 
void SetSortLabel (const std::string &label)
 
void SetSortLabel (const std::wstring &label)
 
const std::wstring & GetSortLabel () const
 
void Select (bool bOnOff)
 
bool IsSelected () const
 
bool HasIcon () const
 
bool HasOverlay () const
 
virtual bool IsFileItem () const
 
void SetLayout (CGUIListItemLayoutPtr layout)
 
CGUIListItemLayoutGetLayout ()
 
void SetFocusedLayout (CGUIListItemLayoutPtr layout)
 
CGUIListItemLayoutGetFocusedLayout ()
 
void FreeIcons ()
 
void FreeMemory (bool immediately=false)
 
void SetInvalid ()
 
void SetProperty (const std::string &strKey, const CVariant &value)
 
void IncrementProperty (const std::string &strKey, int nVal)
 
void IncrementProperty (const std::string &strKey, double dVal)
 
void ClearProperties ()
 
void AppendProperties (const CGUIListItem &item)
 Append the properties of one CGUIListItem to another. Any existing properties in the current item will be overridden if they are set in the passed in item. More...
 
void Archive (CArchive &ar)
 
void Serialize (CVariant &value)
 
bool HasProperty (const std::string &strKey) const
 
bool HasProperties () const
 
void ClearProperty (const std::string &strKey)
 
const CVariantGetProperty (const std::string &strKey) const
 

Public Attributes

bool m_bIsFolder
 is item a folder or a file More...
 

Protected Types

typedef std::map< std::string, CVariant, icomparePropertyMap
 

Protected Attributes

std::string m_strLabel2
 
std::string m_strIcon
 
GUIIconOverlay m_overlayIcon
 
CGUIListItemLayoutPtr m_layout
 
CGUIListItemLayoutPtr m_focusedLayout
 
bool m_bSelected
 
PropertyMap m_mapProperties
 

Member Typedef Documentation

◆ ArtMap

typedef std::map<std::string, std::string> CGUIListItem::ArtMap

◆ PropertyMap

typedef std::map<std::string, CVariant, icompare> CGUIListItem::PropertyMap
protected

Constructor & Destructor Documentation

◆ CGUIListItem() [1/3]

CGUIListItem::CGUIListItem ( void  )

◆ CGUIListItem() [2/3]

CGUIListItem::CGUIListItem ( const CGUIListItem item)

◆ CGUIListItem() [3/3]

CGUIListItem::CGUIListItem ( const std::string &  strLabel)
explicit

◆ ~CGUIListItem()

CGUIListItem::~CGUIListItem ( void  )
virtual

Member Function Documentation

◆ AppendArt()

void CGUIListItem::AppendArt ( const ArtMap art,
const std::string &  prefix = "" 
)

append artwork to an item

Parameters
arta type:url map for artwork
prefixa prefix for the art, if applicable.
See also
GetArt

◆ AppendProperties()

void CGUIListItem::AppendProperties ( const CGUIListItem item)

Append the properties of one CGUIListItem to another. Any existing properties in the current item will be overridden if they are set in the passed in item.

Parameters
itemthe item containing the properties to append.

◆ Archive()

void CGUIListItem::Archive ( CArchive ar)

◆ ClearArt()

void CGUIListItem::ClearArt ( )

clear art on an item

See also
SetArt

◆ ClearProperties()

void CGUIListItem::ClearProperties ( )

◆ ClearProperty()

void CGUIListItem::ClearProperty ( const std::string &  strKey)

◆ Clone()

virtual CGUIListItem * CGUIListItem::Clone ( ) const
inlinevirtual

Reimplemented in CFileItem, and CGUIStaticItem.

◆ FreeIcons()

void CGUIListItem::FreeIcons ( )

◆ FreeMemory()

void CGUIListItem::FreeMemory ( bool  immediately = false)

◆ GetArt() [1/2]

const CGUIListItem::ArtMap & CGUIListItem::GetArt ( ) const

get artwork for an item Retrieves artwork in a type:url map

Returns
a type:url map for artwork
See also
SetArt

◆ GetArt() [2/2]

std::string CGUIListItem::GetArt ( const std::string &  type) const

Get a particular art type for an item.

Parameters
typetype of art to fetch.
Returns
the art URL, if available, else empty.

◆ GetFocusedLayout()

CGUIListItemLayout * CGUIListItem::GetFocusedLayout ( )

◆ GetIconImage()

const std::string & CGUIListItem::GetIconImage ( ) const

◆ GetLabel()

const std::string & CGUIListItem::GetLabel ( ) const

◆ GetLabel2()

const std::string & CGUIListItem::GetLabel2 ( ) const

◆ GetLayout()

CGUIListItemLayout * CGUIListItem::GetLayout ( )

◆ GetOverlayImage()

std::string CGUIListItem::GetOverlayImage ( ) const

◆ GetProperty()

const CVariant & CGUIListItem::GetProperty ( const std::string &  strKey) const

◆ GetSortLabel()

const std::wstring & CGUIListItem::GetSortLabel ( ) const

◆ HasArt()

bool CGUIListItem::HasArt ( const std::string &  type) const

Check whether an item has a particular piece of art Equivalent to !GetArt(type).empty()

Parameters
typetype of art to set.
Returns
true if the item has that art set, false otherwise.

◆ HasIcon()

bool CGUIListItem::HasIcon ( ) const

◆ HasOverlay()

bool CGUIListItem::HasOverlay ( ) const

◆ HasProperties()

bool CGUIListItem::HasProperties ( ) const
inline

◆ HasProperty()

bool CGUIListItem::HasProperty ( const std::string &  strKey) const

◆ IncrementProperty() [1/2]

void CGUIListItem::IncrementProperty ( const std::string &  strKey,
double  dVal 
)

◆ IncrementProperty() [2/2]

void CGUIListItem::IncrementProperty ( const std::string &  strKey,
int  nVal 
)

◆ IsFileItem()

virtual bool CGUIListItem::IsFileItem ( ) const
inlinevirtual

Reimplemented in CFileItem.

◆ IsSelected()

bool CGUIListItem::IsSelected ( ) const

◆ operator=()

CGUIListItem & CGUIListItem::operator= ( const CGUIListItem item)

◆ Select()

void CGUIListItem::Select ( bool  bOnOff)

◆ Serialize()

void CGUIListItem::Serialize ( CVariant value)

◆ SetArt() [1/2]

void CGUIListItem::SetArt ( const ArtMap art)

set artwork for an item

Parameters
arta type:url map for artwork
See also
GetArt

◆ SetArt() [2/2]

void CGUIListItem::SetArt ( const std::string &  type,
const std::string &  url 
)

Set a particular art type for an item.

Parameters
typetype of art to set.
urlthe url of the art.

◆ SetArtFallback()

void CGUIListItem::SetArtFallback ( const std::string &  from,
const std::string &  to 
)

set a fallback image for art

Parameters
fromthe type to fallback from
tothe type to fallback to
See also
SetArt

◆ SetFocusedLayout()

void CGUIListItem::SetFocusedLayout ( CGUIListItemLayoutPtr  layout)

◆ SetIconImage()

void CGUIListItem::SetIconImage ( const std::string &  strIcon)

◆ SetInvalid()

void CGUIListItem::SetInvalid ( )

◆ SetLabel()

void CGUIListItem::SetLabel ( const std::string &  strLabel)
virtual

Reimplemented in CFileItem.

◆ SetLabel2()

void CGUIListItem::SetLabel2 ( const std::string &  strLabel)

◆ SetLayout()

void CGUIListItem::SetLayout ( CGUIListItemLayoutPtr  layout)

◆ SetOverlayImage()

void CGUIListItem::SetOverlayImage ( GUIIconOverlay  icon,
bool  bOnOff = false 
)

◆ SetProperty()

void CGUIListItem::SetProperty ( const std::string &  strKey,
const CVariant value 
)

◆ SetSortLabel() [1/2]

void CGUIListItem::SetSortLabel ( const std::string &  label)

◆ SetSortLabel() [2/2]

void CGUIListItem::SetSortLabel ( const std::wstring &  label)

Member Data Documentation

◆ m_bIsFolder

bool CGUIListItem::m_bIsFolder

is item a folder or a file

◆ m_bSelected

bool CGUIListItem::m_bSelected
protected

◆ m_focusedLayout

CGUIListItemLayoutPtr CGUIListItem::m_focusedLayout
protected

◆ m_layout

CGUIListItemLayoutPtr CGUIListItem::m_layout
protected

◆ m_mapProperties

PropertyMap CGUIListItem::m_mapProperties
protected

◆ m_overlayIcon

GUIIconOverlay CGUIListItem::m_overlayIcon
protected

◆ m_strIcon

std::string CGUIListItem::m_strIcon
protected

◆ m_strLabel2

std::string CGUIListItem::m_strLabel2
protected

The documentation for this class was generated from the following files: