libyui  3.10.0
YItem Class Reference

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

#include <YItem.h>

Inheritance diagram for YItem:

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...
 
int status () const
 Return the status of this item. More...
 
void setStatus (int newStatus)
 Set the status of 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 186 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 195 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 203 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 148 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.

◆ setStatus()

void YItem::setStatus ( int  newStatus)
inline

Set the status of this item.

Most widgets only use 0 for "not selected" or nonzero for "selected". Some widgets may make use of other values as well.

Definition at line 128 of file YItem.h.

◆ status()

int YItem::status ( ) const
inline

Return the status of this item.

This is a bit more generalized than 'selected'. Values other than 0 or 1 can mean different things to the application or to the specific widget.

Definition at line 121 of file YItem.h.


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