Guiliani  Version 2.4 revision 5970 (build 3)
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
 
CGUIListItemoperator= (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 ()
 
CGUITextFieldoperator= (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 CGUITextGetLabel () const
 
CGUITextGetLabel ()
 
CGUIBaseTextFieldoperator= (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 CGUIObjectFindObject (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
 
CGUIBehaviourDecoratorGetBehaviour ()
 
const CGUIBehaviourDecoratorGetBehaviour () const
 
GUIBitmapPlaneID_t GetBitmapID () const
 
CGUIBitmapPlaneGetBitmapPlane () 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
 
CDataPoolConnectorGetDataPoolConnector ()
 
eC_Value GetDistanceBottom () const
 
eC_Value GetDistanceRight () const
 
eC_Value GetHalfHeight () const
 
eC_Value GetHalfWidth () const
 
eC_Value GetHeight () const
 
ObjectHandle_t GetID () const
 
CGUILayouterGetLayouter ()
 
const CGUILayouterGetLayouter () const
 
ObjectHandle_t GetNeighborBottomID () const
 
ObjectHandle_t GetNeighborLeftID () const
 
ObjectHandle_t GetNeighborRightID () const
 
ObjectHandle_t GetNeighborTopID () const
 
CGUIObjectGetObjectByID (const ObjectHandle_t &eID, const eC_Bool &bOnlyVisible=false)
 
const CGUIObjectGetObjectByID (const ObjectHandle_t &eID, const eC_Bool &bOnlyVisible=false) const
 
CGUIRect GetOriginRect () const
 
CGUICompositeObjectGetParent ()
 
const CGUICompositeObjectGetParent () 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)
 
CGUIObjectoperator= (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
CGUITextm_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
pParentPointer to the designated parent object
vXX-position relative to its parent object
vYY-position relative to its parent object
vWidthWidth of the list item
vHeightHeight of the list item
kTexttext string to be displayed on the list item
bMultiLineWhether the internal CGUIText is multi-line
vRelXPosIconX position of the icon relative to this control.
vRelYPosIconY position of the icon relative to this control.
eBackgroundImgimage-id of the background image
eIDObject 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
pParentPointer to the designated parent object
kRectPosition and size of the list item
kTexttext string to be displayed on the list item
bMultiLineWhether the internal CGUIText is multi-line
vRelXPosIconX position of the icon relative to this control.
vRelYPosIconY position of the icon relative to this control.
eBackgroundImgimage-id of the background image
eIDObject 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
pParentPointer to the designated parent object
vXX-position relative to its parent object
vYY-position relative to its parent object
vWidthWidth of the list item
vHeightHeight of the list item
eTextIDID of text string to be displayed on the list item
bMultiLineWhether the internal CGUIText is multi-line
vRelXPosIconX position of the icon relative to this control.
vRelYPosIconY position of the icon relative to this control.
eBackgroundImgimage-id of the background image
eIDObject 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
pParentPointer to the designated parent object
kRectPosition and size of the list item
eTextIDID of text string to be displayed on the list item
bMultiLineWhether the internal CGUIText is multi-line
vRelXPosIconX position of the icon relative to this control.
vRelYPosIconY position of the icon relative to this control.
eBackgroundImgimage-id of the background image
eIDObject Identifier of this list item (choose NO_HANDLE if none is required)

◆ CGUIListItem() [5/6]

CGUIListItem::CGUIListItem ( const CGUIListItem kSource)

CGUIListItem copy-constructor.

Parameters
kSourceSource 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
eIconNormalImage of the icon when item is in normal state.
eIconSelectedImage 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
vRelXPosIconX Position of icon relative to this control.
vRelYPosIconY 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
kSourceSource 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
eIconNormalImage of the icon when item is in normal state.
eIconSelectedImage 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
vRelXPosIconX Position of icon relative to this control.
vRelYPosIconY 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
pParentPointer to new parent object

Reimplemented from CGUIObject.

◆ SetSelected()

void CGUIListItem::SetSelected ( const eC_Bool &  bSelected)

Set the selected state of this control.

Parameters
bSelectedThe color when selected

◆ SetSelectedColor() [1/2]

void CGUIListItem::SetSelectedColor ( const eC_UInt &  uiSelectedColor)

Sets the color of the selected state of this control.

Parameters
uiSelectedColorthe 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
eSelectedColorthe 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
bWriteClassIDThis 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: