Type ListItem

object --+
         |
        ListItem

Known Subclasses:

TextListItem

ListItem () -> ListItem

Creates a new ListItem suitable for the usage in list or tree widgets.

The ListItem class is an abstract class for list implementations.
It is not able to react upon events nor has the flexibility and
capabilities a widget inheriting from the BaseWidget class has, but
provides a minimalistic set of methods to make it suitable for lists
of nearly any type.

ListItems support a 'style' attribute and get_style() method, which
enable them to use different look than default one. The 'style'
attribute of a ListItem usually defaults to a None value and can be
set using the get_style() method. This causes the ListItem internals
to setup the specific style for it and can be accessed through the
'style' attribute later on. A detailled documentation of the style
can be found in the Style class.

if not listitem.style:
    listitem.get_style () # Setup the style internals first.
listitem.style['font']['size'] = 18
listitem.get_style ()['font']['name'] = Arial

The ListItem supports a selection state using the 'selected'
attribute. This indicates, whether the ListItem was selected or not.

listitem.selected = False
listitem.selected = True

ListItems can be set in a dirty state, which indicates, that they
need to be updated. The 'dirty' attribute and set_dirty() method
take care of this and automatically invoke the bound has_changed()
method of the ListItem. In user code, 'dirty' usually does not need
to be modified manually.

listitem.dirty = True
listitem.set_dirty (True)

The ListItem can be bound to or unbounds from a ListItemCollection
using the 'collection' attribute or set_collection() method. This
usually invokes the append() or remove() method of the collection,
so that it can invoke its list_changed() method.

listitem.collection = my_collection
listitem.set_collection (None)

Attributes:
style      - The style to use for drawing the ListItem.
selected   - Indicates, whether the ListItem is currently selected.
collection - The ListItemCollection, the ListItem is attached to.
dirty      - Indicates, that the ListItem needs to be updated.