libyui  3.4.2
YItem Class Reference

Simple item class for SelectionBox, ComboBox, MultiSelectionBox etc. More...

#include <YItem.h>

Inheritance diagram for YItem:
YTableItem YTreeItem YMenuItem YWidgetTreeItem

Public Member Functions

 YItem (const std::string &label, bool selected=false)
 Constructor with just the label and optionally the selected state.
 
 YItem (const std::string &label, const std::string &iconName, bool selected=false)
 Constructor with label and icon name and optionally the selected state.
 
virtual ~YItem ()
 Destructor.
 
std::string label () const
 Return this item's label. More...
 
void setLabel (const std::string &newLabel)
 Set this item's label.
 
std::string iconName () const
 Return this item's icon name.
 
bool hasIconName () const
 Return 'true' if this item has an icon name.
 
void setIconName (const std::string &newIconName)
 Set this item's icon name.
 
bool selected () const
 Return 'true' if this item is currently selected.
 
void setSelected (bool sel=true)
 Select or unselect this item. More...
 
void setIndex (int index)
 Set this item's index.
 
int index () const
 Return the index of this item (as set with setIndex() ).
 
void setData (void *newData)
 Set the opaque data pointer for application use. More...
 
void * data () const
 Return the opaque data pointer.
 
virtual bool hasChildren () const
 Return 'true' if this item has any child items.
 
virtual YItemIterator childrenBegin ()
 Return an iterator that points to the first child item of this item. More...
 
virtual YItemConstIterator childrenBegin () const
 
virtual YItemIterator childrenEnd ()
 Return an iterator that points after the last child item of this item. More...
 
virtual YItemConstIterator childrenEnd () const
 
virtual YItemparent () const
 Returns this item's parent item or 0 if it is a toplevel item. More...
 

Detailed Description

Simple item class for SelectionBox, ComboBox, MultiSelectionBox etc.

items. This class provides stubs for children management.

Definition at line 49 of file YItem.h.

Member Function Documentation

◆ childrenBegin()

virtual YItemIterator YItem::childrenBegin ( )
inlinevirtual

Return an iterator that points to the first child item of this item.

This default implementation returns the 'end' iterator of the class-static always empty _noChildren YItemCollection. It is safe to use this iterator in classic iterator loops:

for ( YItemIterator it = myItem->childrenBegin(); it != myItem->childrenEnd(); ++it ) { ... }

The loop body will only ever be executed if this item is a derived class that actually manages child items.

Reimplemented in YTreeItem.

Definition at line 172 of file YItem.h.

◆ childrenEnd()

virtual YItemIterator YItem::childrenEnd ( )
inlinevirtual

Return an iterator that points after the last child item of this item.

This default implementation returns the 'end' iterator of the class-static always empty _noChildren YItemCollection.

Reimplemented in YTreeItem.

Definition at line 181 of file YItem.h.

◆ label()

std::string YItem::label ( ) const
inline

Return this item's label.

This is what the user sees in a dialog, so this will usually be a translated text.

Definition at line 82 of file YItem.h.

◆ parent()

virtual YItem* YItem::parent ( ) const
inlinevirtual

Returns this item's parent item or 0 if it is a toplevel item.

This default implementation always returns 0. Derived classes that handle children should reimplement this.

Reimplemented in YTreeItem, and YMenuItem.

Definition at line 189 of file YItem.h.

◆ setData()

void YItem::setData ( void *  newData)
inline

Set the opaque data pointer for application use.

Applications can use this to store the pointer to a counterpart of this tree item. It is the application's responsibility to watch for dangling pointers and possibliy deleting the data. All this class ever does with this pointer is to store it.

Definition at line 134 of file YItem.h.

◆ setSelected()

void YItem::setSelected ( bool  sel = true)
inline

Select or unselect this item.

This does not have any effect on any other item; if it is desired that only one item is selected at any time, the caller has to take care of that.

Definition at line 114 of file YItem.h.


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