CGUIListItem Class Reference

A list item is a control that is shown in a list as an element. More...

#include <GUIListItem.h>

Inheritance diagram for CGUIListItem:

Public Member Functions
	CGUIListItem (CGUIListBox *const pParent, const eC_Value &vX, const eC_Value &vY, const eC_Value &vWidth, const eC_Value &vHeight, const eC_String &kText, const eC_Bool &bMultiLine=false, const eC_Value &vRelXPosIcon=eC_FromInt(0), const eC_Value &vRelYPosIcon=eC_FromInt(0), const ImageResource_t &eBackgroundImg=DUMMY_IMAGE, const ObjectHandle_t &eID=NO_HANDLE)
	CGUIListItem (CGUIListBox *const pParent, const CGUIRect &kRect, const eC_String &kText, const eC_Bool &bMultiLine=false, const eC_Value &vRelXPosIcon=eC_FromInt(0), const eC_Value &vRelYPosIcon=eC_FromInt(0), const ImageResource_t &eBackgroundImg=DUMMY_IMAGE, const ObjectHandle_t &eID=NO_HANDLE)
	CGUIListItem (CGUIListBox *const pParent, const eC_Value &vX, const eC_Value &vY, const eC_Value &vWidth, const eC_Value &vHeight, const TextResource_t &eTextID, const eC_Bool &bMultiLine=false, const eC_Value &vRelXPosIcon=eC_FromInt(0), const eC_Value &vRelYPosIcon=eC_FromInt(0), const ImageResource_t &eBackgroundImg=DUMMY_IMAGE, const ObjectHandle_t &eID=NO_HANDLE)
	CGUIListItem (CGUIListBox *const pParent, const CGUIRect &kRect, const TextResource_t &eTextID, const eC_Bool &bMultiLine=false, const eC_Value &vRelXPosIcon=eC_FromInt(0), const eC_Value &vRelYPosIcon=eC_FromInt(0), const ImageResource_t &eBackgroundImg=DUMMY_IMAGE, const ObjectHandle_t &eID=NO_HANDLE)
	CGUIListItem (const CGUIListItem &kSource)
	CGUIListItem ()
virtual	~CGUIListItem ()
eC_Bool	DoDraw ()
void	GetIconImages (ImageResource_t &eIconNormal, ImageResource_t &eIconSelected)
void	GetIconPos (eC_Value &vRelXPosIcon, eC_Value &vRelYPosIcon)
eC_UInt	GetSelectedColor () const
eC_Bool	IsSelected () const
CGUIListItem &	operator= (const CGUIListItem &kSource)
virtual void	ReadFromStream ()
void	SetIconImages (const ImageResource_t &eIconNormal, const ImageResource_t &eIconSelected)
void	SetIconPos (const eC_Value &vRelXPosIcon, const eC_Value &vRelYPosIcon)
void	SetParent (CGUICompositeObject *const pParent)
void	SetSelected (const eC_Bool &bSelected)
void	SetSelectedColor (const eC_UInt &uiSelectedColor)
void	SetSelectedColor (const GlobalProperty_t &eSelectedColor)
virtual void	WriteToStream (const eC_Bool bWriteClassID=false)
Public Member Functions inherited from CGUITextField
	CGUITextField (CGUICompositeObject *const pParent, const eC_Value &vX, const eC_Value &vY, const eC_Value &vWidth, const eC_Value &vHeight, const eC_String &kText, const eC_Bool &bMultiLine=false, const ImageResource_t &eBackgroundImg=DUMMY_IMAGE, const ObjectHandle_t &eID=NO_HANDLE)
	CGUITextField (CGUICompositeObject *const pParent, const CGUIRect &kRect, const eC_String &kText, const eC_Bool &bMultiLine=false, const ImageResource_t &eBackgroundImg=DUMMY_IMAGE, const ObjectHandle_t &eID=NO_HANDLE)
	CGUITextField (CGUICompositeObject *const pParent, const eC_Value &vX, const eC_Value &vY, const eC_Value &vWidth, const eC_Value &vHeight, const TextResource_t &eTextID, const eC_Bool &bMultiLine=false, const ImageResource_t &eBackgroundImg=DUMMY_IMAGE, const ObjectHandle_t &eID=NO_HANDLE)
	CGUITextField (CGUICompositeObject *const pParent, const CGUIRect &kRect, const TextResource_t &eTextID, const eC_Bool &bMultiLine=false, const ImageResource_t &eBackgroundImg=DUMMY_IMAGE, const ObjectHandle_t &eID=NO_HANDLE)
	CGUITextField (const CGUITextField &kSource)
	CGUITextField ()
	~CGUITextField ()
eC_Bool	DoDraw ()
CGUITextField &	operator= (const CGUITextField &kSource)
void	SetBackgroundImage (const ImageResource_t &eBackgroundImg)
Public Member Functions inherited from CGUIBaseTextField
	CGUIBaseTextField (CGUICompositeObject *const pParent, const eC_Value &vX, const eC_Value &vY, const eC_Value &vWidth, const eC_Value &vHeight, const eC_String &kText, const eC_Bool &bMultiLine=false, const eC_UInt &uiBackgroundColor=0x00000000, const ObjectHandle_t &eID=NO_HANDLE)
	CGUIBaseTextField (CGUICompositeObject *const pParent, const CGUIRect &kRect, const eC_String &kText, const eC_Bool &bMultiLine=false, const eC_UInt &uiBackgroundColor=0x00000000, const ObjectHandle_t &eID=NO_HANDLE)
	CGUIBaseTextField (CGUICompositeObject *const pParent, const eC_Value &vX, const eC_Value &vY, const eC_Value &vWidth, const eC_Value &vHeight, const TextResource_t &eTextID, const eC_Bool &bMultiLine=false, const eC_UInt &uiBackgroundColor=0x00000000, const ObjectHandle_t &eID=NO_HANDLE)
	CGUIBaseTextField (CGUICompositeObject *const pParent, const CGUIRect &kRect, const TextResource_t &eTextID, const eC_Bool &bMultiLine=false, const eC_UInt &uiBackgroundColor=0x00000000, const ObjectHandle_t &eID=NO_HANDLE)
	CGUIBaseTextField (const CGUIBaseTextField &kSource)
	CGUIBaseTextField ()
	~CGUIBaseTextField ()
eC_UInt	GetBackgroundColor () const
const CGUIText *	GetLabel () const
CGUIText *	GetLabel ()
CGUIBaseTextField &	operator= (const CGUIBaseTextField &kSource)
void	SetBackgroundColor (const eC_UInt &uiBackgroundColor)
void	SetBackgroundColor (const GlobalProperty_t &eBackgroundColor)
virtual void	SetHeight (const eC_Value &vNewHeight)
void	SetLabel (const TextResource_t &eTextID)
void	SetLabel (const eC_String &rkText)
void	SetText (CGUIText *pkText)
virtual eC_Bool	SetValue (const CGUIValue &rkValue)
virtual void	SetWidth (const eC_Value &vNewWidth)
Public Member Functions inherited from CGUIObject
	CGUIObject (CGUICompositeObject *const pParent, const eC_Value &vX, const eC_Value &vY, const eC_Value &vWidth, const eC_Value &vHeight, const ObjectHandle_t &eID=NO_HANDLE)
	CGUIObject (CGUICompositeObject *const pParent, const CGUIRect &kRect, const ObjectHandle_t &eID=NO_HANDLE)
	CGUIObject ()
	CGUIObject (const CGUIObject &kSource)
virtual	~CGUIObject ()
void	AddValueObserver (CGUIObserver *pObserver)
eC_Bool	CalculateInvalidatedRect (CGUIRect &rRect) const
virtual eC_Bool	ClaimFocus ()
virtual void	CreateSnapshot (eC_UInt uiBackColor=0x00)
eC_Bool	DataPoolConnectorExists () const
void	DeleteSnapshot ()
virtual void	DisableSnapshotDrawing (eC_Bool bDeleteSnapshot=true)
virtual eC_Bool	DoDrawSnapshot ()
virtual void	EnableSnapshotDrawing ()
virtual CGUIObject *	FindObject (const eC_Value &vAbsX, const eC_Value &vAbsY)
virtual eC_Bool	FocusAny ()
virtual eC_Bool	FocusNext (CGUIObject *const pRefObj=NULL, const eC_Bool &bSubTreeOfRefObjDone=false)
virtual eC_Bool	FocusPrevious (CGUIObject *const pRefObj=NULL, const eC_Bool &bSubTreeOfRefObjDone=false)
CGUIRect	GetAbsRect () const
eC_Value	GetAbsXPos () const
eC_Value	GetAbsXPosCenter () const
eC_Value	GetAbsXPosREdge () const
eC_Value	GetAbsYPos () const
eC_Value	GetAbsYPosBEdge () const
eC_Value	GetAbsYPosCenter () const
eC_UByte	GetAlpha () const
CGUIBehaviourDecorator *	GetBehaviour ()
const CGUIBehaviourDecorator *	GetBehaviour () const
GUIBitmapPlaneID_t	GetBitmapID () const
CGUIBitmapPlane &	GetBitmapPlane () const
CGUIRect	GetCurrentAbsRect () const
eC_Value	GetCurrentAbsXPos () const
eC_Value	GetCurrentAbsXPosCenter () const
eC_Value	GetCurrentAbsXPosREdge () const
eC_Value	GetCurrentAbsYPos () const
eC_Value	GetCurrentAbsYPosBEdge () const
eC_Value	GetCurrentAbsYPosCenter () const
CDataPoolConnector &	GetDataPoolConnector ()
eC_Value	GetDistanceBottom () const
eC_Value	GetDistanceRight () const
eC_Value	GetHalfHeight () const
eC_Value	GetHalfWidth () const
eC_Value	GetHeight () const
ObjectHandle_t	GetID () const
CGUILayouter *	GetLayouter ()
const CGUILayouter *	GetLayouter () const
ObjectHandle_t	GetNeighborBottomID () const
ObjectHandle_t	GetNeighborLeftID () const
ObjectHandle_t	GetNeighborRightID () const
ObjectHandle_t	GetNeighborTopID () const
CGUIObject *	GetObjectByID (const ObjectHandle_t &eID, const eC_Bool &bOnlyVisible=false)
const CGUIObject *	GetObjectByID (const ObjectHandle_t &eID, const eC_Bool &bOnlyVisible=false) const
CGUIRect	GetOriginRect () const
CGUICompositeObject *	GetParent ()
const CGUICompositeObject *	GetParent () const
CGUIRect	GetRelRect () const
eC_Value	GetRelXPos () const
eC_Value	GetRelXPosCenter () const
eC_Value	GetRelXPosREdge () const
eC_Value	GetRelYPos () const
eC_Value	GetRelYPosBEdge () const
eC_Value	GetRelYPosCenter () const
eC_Value	GetWidth () const
void	InvalidateArea ()
eC_Bool	IsClickable () const
eC_Bool	IsClickThrough () const
virtual eC_Bool	IsCompositeObject () const
eC_Bool	IsDescendantOf (const CGUIObject *const pAncestor) const
eC_Bool	IsDisabled () const
eC_Bool	IsDragable () const
eC_Bool	IsDragged () const
eC_Bool	IsDrawingSnapshot () const
eC_Bool	IsFocussable () const
eC_Bool	IsFocussed () const
eC_Bool	IsGrayedOut () const
virtual eC_Bool	IsHighlightable () const
eC_Bool	IsHighlighted () const
eC_Bool	IsInvisible () const
eC_Bool	IsPressed () const
eC_Bool	IsStopFocus () const
void	NotifyValueObservers (const CGUIValue &kValue, const eC_UInt uiX=0, const eC_UInt uiY=0)
CGUIObject &	operator= (const CGUIObject &kSource)
virtual void	RefreshLayout (CGUILayouter::eMovedEdges_t eMovedEdges) const
void	RemoveValueObserver (CGUIObserver *pObserver)
void	RenderToBitmap (eC_UInt uiBitmapID, eC_Value vXOffset=eC_FromInt(0), eC_Value vYOffset=eC_FromInt(0))
eC_Bool	RequestFocus ()
void	SetAlpha (eC_UByte ubAlpha)
void	SetBehaviour (CGUIBehaviourDecorator *pBehaviour)
void	SetClickThrough (const eC_Bool &bClickThrough)
virtual void	SetDisabled (const eC_Bool &bDisabled)
virtual void	SetFocussable (const eC_Bool &bFocussable)
virtual void	SetGrayedOut (const eC_Bool &bGrayOut)
void	SetID (const ObjectHandle_t &eID)
virtual void	SetInvisible (const eC_Bool &bInvisible)
void	SetLayouter (CGUILayouter *pLayouter)
void	SetNeighborBottomID (const ObjectHandle_t eNewNeighborBottomID)
void	SetNeighborIDs (const ObjectHandle_t eNewNeighborLeftID, const ObjectHandle_t eNewNeighborRightID, const ObjectHandle_t eNewNeighborTopID, const ObjectHandle_t eNewNeighborBottomID)
void	SetNeighborLeftID (const ObjectHandle_t eNewNeighborLeftID)
void	SetNeighborRightID (const ObjectHandle_t eNewNeighborRightID)
void	SetNeighborTopID (const ObjectHandle_t eNewNeighborTopID)
void	SetRelRect (const CGUIRect &kNewRect)
virtual void	SetRelXPos (const eC_Value &vX)
void	SetRelXPosCenter (const eC_Value &vXCenter)
void	SetRelXPosREdge (const eC_Value &vX)
virtual void	SetRelYPos (const eC_Value &vY)
void	SetRelYPosBEdge (const eC_Value &vY)
void	SetRelYPosCenter (const eC_Value &vYCenter)
void	SetStopFocus (const eC_Bool &bDontFocusToParent)
virtual eC_Bool	SetValue (CDataPoolEntry &rkValue)
Public Member Functions inherited from CGUIBehaviour
virtual eC_Bool	DoUserEvent (CGUIEvent *const pEvent)
virtual void	OnCreate ()
virtual void	OnDelete ()
virtual void	OnHide ()
virtual void	OnShow ()
virtual eC_Bool	DoClick (const eC_Value &vAbsX=eC_FromInt(-1), const eC_Value &vAbsY=eC_FromInt(-1))
virtual eC_Bool	DoLongClick (const eC_Value &vAbsX=eC_FromInt(-1), const eC_Value &vAbsY=eC_FromInt(-1))
virtual eC_Bool	DoDoubleClick (const eC_Value &vAbsX=eC_FromInt(-1), const eC_Value &vAbsY=eC_FromInt(-1))
virtual eC_Bool	DoButtonDown (const eC_Value &vAbsX=eC_FromInt(-1), const eC_Value &vAbsY=eC_FromInt(-1))
virtual eC_Bool	DoButtonUp (const eC_Value &vAbsX=eC_FromInt(-1), const eC_Value &vAbsY=eC_FromInt(-1))
virtual eC_Bool	DoDrag (const eC_Value &vDeltaX=eC_FromInt(-1), const eC_Value &vDeltaY=eC_FromInt(-1), const eC_Value &vAbsX=eC_FromInt(-1), const eC_Value &vAbsY=eC_FromInt(-1))
virtual eC_Bool	DoDragEnd (const eC_Value &vAbsX=eC_FromInt(-1), const eC_Value &vAbsY=eC_FromInt(-1))
virtual eC_Bool	DoMouseEnter (const eC_Value &vAbsX=eC_FromInt(-1), const eC_Value &vAbsY=eC_FromInt(-1))
virtual eC_Bool	DoMouseLeave (const eC_Value &vAbsX=eC_FromInt(-1), const eC_Value &vAbsY=eC_FromInt(-1))
virtual eC_Bool	DoMouseMove (const eC_Value &vAbsX=eC_FromInt(-1), const eC_Value &vAbsY=eC_FromInt(-1))
virtual void	GetFocus ()
virtual void	LoseFocus ()
virtual eC_Bool	Decrease ()
virtual eC_Bool	Increase ()
virtual eC_Bool	DoKeyDown (const GUIKeyIdentifier_t &eKeyIdentifier, const eC_UInt &uiModifiers)
virtual eC_Bool	DoKeyUp (const GUIKeyIdentifier_t &eKeyIdentifier, const eC_UInt &uiModifiers)
virtual eC_Bool	DoChar (const eC_UInt &uiKey, const GUIKeyIdentifier_t &eKeyIdentifier, const eC_UInt &uiModifiers)
virtual eC_Bool	DoScrollUp (const eC_Value &vAbsX, const eC_Value &vAbsY)
virtual eC_Bool	DoScrollDown (const eC_Value &vAbsX, const eC_Value &vAbsY)
virtual eC_Bool	DoScrollLeft (const eC_Value &vAbsX, const eC_Value &vAbsY)
virtual eC_Bool	DoScrollRight (const eC_Value &vAbsX, const eC_Value &vAbsY)
Public Member Functions inherited from CGUIStreamableObject
const eC_String &	GetXMLTag () const
void	SetXMLTag (const eC_String &kXMLTag)
Public Member Functions inherited from CGUIAnimatable
virtual	~CGUIAnimatable ()
	Destructor. Removes all existing animation callbacks.
virtual void	DoAnimate (const eC_Value &vTimes=eC_FromInt(1))
virtual eC_Bool	IsAnimating () const
virtual void	StartAnimation ()
virtual void	StopAnimation ()
Public Member Functions inherited from CGUIColorPropertyObserver
	CGUIColorPropertyObserver ()
	default-constructor
	~CGUIColorPropertyObserver ()
	destructor
eC_UInt	AddColorProperty (const eC_Bool &bColorIsProperty, const eC_UInt &uiColorValue, const GlobalProperty_t &eColorProperty)
void	AddColorProperty (const eC_UInt &uiIndex, const eC_Bool &bColorIsProperty, const eC_UInt &uiColorValue, const GlobalProperty_t &eColorProperty)
ColorValue_t	GetColorProperty (const eC_UInt &uiIndex) const
eC_UInt	GetColorValue (const eC_UInt &uiIndex) const
virtual void	OnColorPropertyChange ()
virtual void	OnNotification ()
	Called by CGUISubject whenever an observed object triggers an update.
void	RemoveColorProperty (const eC_UInt &uiIndex)
void	SetColorProperty (const eC_UInt &uiIndex, const eC_UInt &uiColorValue)
void	SetColorProperty (const eC_UInt &uiIndex, const GlobalProperty_t &eColorProperty)
void	SetColorProperty (const eC_UInt &uiIndex, const ColorValue_t &kColorValue)
Public Member Functions inherited from CGUIObserver
	CGUIObserver ()
	Default constructor.
virtual	~CGUIObserver ()
	Default destructor. Notifies all subjects of destruction.
const eC_TListDoubleLinked< CGUISubject * > &	GetSubjectList () const
virtual void	OnNotification (const eC_String &kMessage)
virtual void	OnNotification (const CGUIObject *const pkUpdatedObject)
virtual void	OnNotification (const CGUIValue &kObservedValue, const CGUIObject *const pkUpdatedObject, const eC_UInt uiX=0, const eC_UInt uiY=0)
void	SetAutoDelete (const eC_Bool bAutoDelete)

Protected Attributes
eC_Bool	m_bSelected
	Indicate whether the control is selected or not.
ImageResource_t	m_eIconNormal
	The icon image drawn in standard state.
ImageResource_t	m_eIconSelected
	The icon image drawn in selected state.
eC_Value	m_vRelXPosIcon
	Stores X-Position of icon. This is relative to the control.
eC_Value	m_vRelYPosIcon
	Stores Y-Position of icon. This is relative to the control.
Protected Attributes inherited from CGUITextField
ImageResource_t	m_eBackgroundImg
	ID of the background image.
CGUINinePatch	m_kNinePatch
	the nine patch
Protected Attributes inherited from CGUIBaseTextField
CGUIText *	m_pkText
	The text displayed by this text field.

Additional Inherited Members
Public Types inherited from CGUIObject
enum	FourWayFocus_t { FOCUS_LEFT, FOCUS_RIGHT, FOCUS_UP, FOCUS_DOWN }
Static Public Attributes inherited from CGUIBaseTextField
static const eC_Char	XMLTAG_BASETEXTFIELD [] = "GUIBaseTextField"
	xml-tag for the class itself
static const eC_Char	XMLTAG_BASETEXTFIELD_BACKGROUNDCOLOR [] = "BackgroundColor"
	xml-tag for background-color
Static Public Attributes inherited from CGUIObject
static const eC_Char	XMLTAG_ALPHA [] = "Alpha"
	XML tag to be used writing alpha-value into a stream.
static const eC_Char	XMLTAG_CLICKTHROUGH [] = "ClickThrough"
	XML tag to be used writing clickthrough-state into a stream.
static const eC_Char	XMLTAG_CONTROLCLASSID [] = "ControlClassID"
	XML tag to be used when writing a control class ID into a stream.
static const eC_Char	XMLTAG_DISABLED [] = "Disabled"
	XML tag to be used writing disabled-state into a stream.
static const eC_Char	XMLTAG_FOCUSSABLE [] = "Focussable"
	XML tag to be used writing focussable-state into a stream.
static const eC_Char	XMLTAG_GRAYEDOUT [] = "GrayedOut"
	XML tag to be used writing grayedout-state into a stream.
static const eC_Char	XMLTAG_HEIGHT [] = "Height"
	XML tag to be used writing height into a stream.
static const eC_Char	XMLTAG_INVISIBLE [] = "Invisible"
	XML tag to be used writing invisible-state into a stream.
static const eC_Char	XMLTAG_OBJECTID [] = "ObjectID"
	XML tag to be used writing object id into a stream.
static const eC_Char	XMLTAG_OVERRIDDENNEIGHBORS [] = "OverriddenNeighbors"
	XML tag to be used writing overridden neighbors into a stream.
static const eC_Char	XMLTAG_WIDTH [] = "Width"
	XML tag to be used writing width into a stream.
static const eC_Char	XMLTAG_XPOS [] = "XPos"
	XML tag to be used writing x-position into a stream.
static const eC_Char	XMLTAG_YPOS [] = "YPos"
	XML tag to be used writing y-position into a stream.
Static Public Attributes inherited from CGUIBehaviour
static const eC_Char	XMLTAG_BEHAVIOURCLASSID [] = "BehaviourClassID"
	XML tag to be used when writing a behaviour class ID into a stream.
Static Public Attributes inherited from CGUIStreamableObject
static const eC_Char	XMLTAG_CLASSVERSION [] = "ClassVersion"
Protected Member Functions inherited from CGUIObject
virtual eC_Bool	CreateBitmapPlane ()
virtual eC_Bool	FourWayNext (FourWayFocus_t eFocusDirection)
Protected Member Functions inherited from CGUIStreamableObject
eC_UInt	ReadStreamingHeader (const eC_UInt &uiClassVersion, const eC_UInt &uiClassMinVersion=0) const
void	WriteStreamingFooter (const eC_Bool &bWriteClassID) const
void	WriteStreamingHeader (const eC_Bool &bWriteClassID, const eC_Char *const pkClassIDTag, const eC_Int &iClassID, const eC_UInt &uiClassVersion) const
Protected Member Functions inherited from CGUIObserver
virtual void	AddSubject (CGUISubject *pSubjectToAdd)
virtual void	RemoveSubject (CGUISubject *pSubjectToRemove)

Detailed Description

A list item is a control that is shown in a list as an element.

It has a text inside it to describe the element.

The additonal feature of the list item to the GUIBaseTextField is that it can change color after the user highlighted it or the element is focused. This state is called selected in this control.

This control shows an additional icon on the text field. The user is responsible for setting the icon image size and its position with SetIconImages and SetIconPos methods.

The SetSelected() method is written to set the selected state. The selected state of this control can be known by calling the method IsSelected. The color of the selected state of this control can be changed by calling method SetSelectedColor().

Example:

// Create a list item.
CGUIListItem *pkListItem = new CGUIListItem(this,
eC_FromInt(0), eC_FromInt(0),
eC_FromInt(110), eC_FromInt(30),
"",
false,
eC_FromInt(0), eC_FromInt(0),
DUMMY_IMAGE,
OBJ_LISTITEM);

// Set the selected state of this control.
pkListItem->SetSelected(true);

// Set position of icon inside the control.
pkListItem->SetIconPos(eC_FromInt(10), eC_FromInt(10));

// Set icons of the controls.
// Before calling this method, please add image IDs to UserImageResource.h.
// After that call GETRESMANAGER.RegisterImageResource() to register images for image IDs.
pkListItem->SetIconImages(
ICON_NORMAL,
ICON_SELECTED);

Constructor & Destructor Documentation

CGUIListItem() [1/6]

CGUIListItem::CGUIListItem	(	CGUIListBox *const	pParent,
		const eC_Value &	vX,
		const eC_Value &	vY,
		const eC_Value &	vWidth,
		const eC_Value &	vHeight,
		const eC_String &	kText,
		const eC_Bool &	bMultiLine = false,
		const eC_Value &	vRelXPosIcon = eC_FromInt(0),
		const eC_Value &	vRelYPosIcon = eC_FromInt(0),
		const ImageResource_t &	eBackgroundImg = DUMMY_IMAGE,
		const ObjectHandle_t &	eID = NO_HANDLE
	)

Constructs a list item from a string and area values.

Parameters

pParent	Pointer to the designated parent object
vX	X-position relative to its parent object
vY	Y-position relative to its parent object
vWidth	Width of the list item
vHeight	Height of the list item
kText	text string to be displayed on the list item
bMultiLine	Whether the internal CGUIText is multi-line
vRelXPosIcon	X position of the icon relative to this control.
vRelYPosIcon	Y position of the icon relative to this control.
eBackgroundImg	image-id of the background image
eID	Object Identifier of this list item (choose NO_HANDLE if none is required)

CGUIListItem() [2/6]

CGUIListItem::CGUIListItem	(	CGUIListBox *const	pParent,
		const CGUIRect &	kRect,
		const eC_String &	kText,
		const eC_Bool &	bMultiLine = false,
		const eC_Value &	vRelXPosIcon = eC_FromInt(0),
		const eC_Value &	vRelYPosIcon = eC_FromInt(0),
		const ImageResource_t &	eBackgroundImg = DUMMY_IMAGE,
		const ObjectHandle_t &	eID = NO_HANDLE
	)

Constructs a list item from a string and a rectangle area.

Parameters

pParent	Pointer to the designated parent object
kRect	Position and size of the list item
kText	text string to be displayed on the list item
bMultiLine	Whether the internal CGUIText is multi-line
vRelXPosIcon	X position of the icon relative to this control.
vRelYPosIcon	Y position of the icon relative to this control.
eBackgroundImg	image-id of the background image
eID	Object Identifier of this list item (choose NO_HANDLE if none is required)

CGUIListItem() [3/6]

CGUIListItem::CGUIListItem	(	CGUIListBox *const	pParent,
		const eC_Value &	vX,
		const eC_Value &	vY,
		const eC_Value &	vWidth,
		const eC_Value &	vHeight,
		const TextResource_t &	eTextID,
		const eC_Bool &	bMultiLine = false,
		const eC_Value &	vRelXPosIcon = eC_FromInt(0),
		const eC_Value &	vRelYPosIcon = eC_FromInt(0),
		const ImageResource_t &	eBackgroundImg = DUMMY_IMAGE,
		const ObjectHandle_t &	eID = NO_HANDLE
	)

Constructs a list item from a text ID and area values.

Parameters

pParent	Pointer to the designated parent object
vX	X-position relative to its parent object
vY	Y-position relative to its parent object
vWidth	Width of the list item
vHeight	Height of the list item
eTextID	ID of text string to be displayed on the list item
bMultiLine	Whether the internal CGUIText is multi-line
vRelXPosIcon	X position of the icon relative to this control.
vRelYPosIcon	Y position of the icon relative to this control.
eBackgroundImg	image-id of the background image
eID	Object Identifier of this list item (choose NO_HANDLE if none is required)

CGUIListItem() [4/6]

CGUIListItem::CGUIListItem	(	CGUIListBox *const	pParent,
		const CGUIRect &	kRect,
		const TextResource_t &	eTextID,
		const eC_Bool &	bMultiLine = false,
		const eC_Value &	vRelXPosIcon = eC_FromInt(0),
		const eC_Value &	vRelYPosIcon = eC_FromInt(0),
		const ImageResource_t &	eBackgroundImg = DUMMY_IMAGE,
		const ObjectHandle_t &	eID = NO_HANDLE
	)

Constructs a list item from a text ID and a rectangle area.

Parameters

pParent	Pointer to the designated parent object
kRect	Position and size of the list item
eTextID	ID of text string to be displayed on the list item
bMultiLine	Whether the internal CGUIText is multi-line
vRelXPosIcon	X position of the icon relative to this control.
vRelYPosIcon	Y position of the icon relative to this control.
eBackgroundImg	image-id of the background image
eID	Object Identifier of this list item (choose NO_HANDLE if none is required)

CGUIListItem() [5/6]

CGUIListItem::CGUIListItem

(

const CGUIListItem &

kSource

)

CGUIListItem copy-constructor.

Parameters

kSource

Source object to be copied

CGUIListItem() [6/6]

CGUIListItem::CGUIListItem

(

void

)

Standard constructor.

See also

CGUIObject().

~CGUIListItem()

CGUIListItem::~CGUIListItem ( void  )

virtual

Destructor.

Member Function Documentation

DoDraw()

eC_Bool CGUIListItem::DoDraw ( )

virtual

Visualizes the object. It is forbidden to call SetRelXPos, SetRelYPos, SetWidth or SetHeight in DoDraw, i.e., it is not allowed to change the layout.

Returns

True if anything was drawn, False otherwise

Reimplemented from CGUIBaseTextField.

GetIconImages()

void CGUIListItem::GetIconImages	(	ImageResource_t &	eIconNormal,
		ImageResource_t &	eIconSelected
	)

Returns the list item's icon images

Parameters

eIconNormal	Image of the icon when item is in normal state.
eIconSelected	Image of the icon when item is in selected state.

GetIconPos()

void CGUIListItem::GetIconPos	(	eC_Value &	vRelXPosIcon,
		eC_Value &	vRelYPosIcon
	)

Function to get position of icon inside the control.

Parameters

vRelXPosIcon	X Position of icon relative to this control.
vRelYPosIcon	Y Position of icon relative to this control.

GetSelectedColor()

eC_UInt CGUIListItem::GetSelectedColor

(

)

const

Retrieves the color of the selected state of this control.

Returns

The color

IsSelected()

eC_Bool CGUIListItem::IsSelected

(

)

const

Return whether the list item is currently selected.

Returns

True if selected

operator=()

CGUIListItem & CGUIListItem::operator=

(

const CGUIListItem &

kSource

)

CGUIListItem operator= to copy the whole CGUIListItem.

Parameters

kSource

Source object to be copied

Returns

Copied object

ReadFromStream()

void CGUIListItem::ReadFromStream ( )

virtual

Reads all object attributes from streaming file. Only for use with GUIFactory. GUIStreamingFileReader has to be set in CGUI::Init().

See also

CGUIFactory

Reimplemented from CGUITextField.

SetIconImages()

void CGUIListItem::SetIconImages	(	const ImageResource_t &	eIconNormal,
		const ImageResource_t &	eIconSelected
	)

Function to set icons of the controls.

Parameters

eIconNormal	Image of the icon when item is in normal state.
eIconSelected	Image of the icon when item is in selected state.

SetIconPos()

void CGUIListItem::SetIconPos	(	const eC_Value &	vRelXPosIcon,
		const eC_Value &	vRelYPosIcon
	)

Function to set position of icon inside the control.

Parameters

vRelXPosIcon	X Position of icon relative to this control.
vRelYPosIcon	Y Position of icon relative to this control.

SetParent()

void CGUIListItem::SetParent ( CGUICompositeObject *const  pParent )

virtual

Assign this object to a different parent. This will automatically remove it from the current parent's childlist, and append it to the new parent.

Parameters

pParent

Pointer to new parent object

Reimplemented from CGUIObject.

SetSelected()

void CGUIListItem::SetSelected

(

const eC_Bool &

bSelected

)

Set the selected state of this control.

Parameters

bSelected

The color when selected

SetSelectedColor() [1/2]

void CGUIListItem::SetSelectedColor

(

const eC_UInt &

uiSelectedColor

)

Sets the color of the selected state of this control.

Parameters

uiSelectedColor

the color in ARGB coding(Form: 0xAARRGGBB,e.g.0xFFFF0000 = Red(fully opaque)). (Alpha, Red, Green, and Blue, simple:ARGB.)

SetSelectedColor() [2/2]

void CGUIListItem::SetSelectedColor

(

const GlobalProperty_t &

eSelectedColor

)

Sets the color of the selected state of this control.

Parameters

eSelectedColor

the color in ARGB coding(Form: 0xAARRGGBB,e.g.0xFFFF0000 = Red(fully opaque)). (Alpha, Red, Green, and Blue, simple:ARGB.)

WriteToStream()

void CGUIListItem::WriteToStream ( const eC_Bool  bWriteClassID = false )

virtual

Writes all object attributes to the streaming file. StreamWriter has to be initialized. Only for use with GUIStreamWriter.

Parameters

bWriteClassID

This flag is used to select if writing of ControlID, leading and trailing tags is performed. Only GUIStreamWriter and GUICompositeObject have to set this flag true.

See also

CGUIStreamWriter

Reimplemented from CGUITextField.

---

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

• GUIListItem.h
• GUIListItem.cpp