The constructors create a new BListItem object. The level and expanded arguments are only used if the item is added to a BOutlineListView object; see BOutlineListView::AddItem() for more information.

The destructor is empty.

Hook function that's invoked when the item's owner (a BListView object) needs to draw this item. itemRect is the area within the owner to which the item's drawing is clipped. If drawEverything is true, this function should touch every pixel in itemRect; if it's false, the function can assume that the background color for the item is already painted. DrawItem() should be implemented to visually reflect the state of the item, highlighting it if it's selected, dimming it if it's disabled, and so on.

The owner view provides the drawing environment for this item. All drawing instructions should be invoked on owner. See "Creating a Custom List Item" for an example DrawItem() function.

Hook function that's called whenever the item's owner changes in a way that could affect the appearance of this item. It's always called when the item is added to a list view.

The default implementation sets the item's width to that of the owner, and sets its height so it will accommodate font (the owner's current BFont setting).

Returns the outline level of the item; this is only meaningful if the item is in a BOutlineListView.

Select() and Deselect() set the item's selected state; IsSelected() returns the state. The setting functions don't automatically update the item's display: After calling Select() or Deselect(), you must tell the owner to redrawn this item (see BListView::InvalidateItem()).

Also, Select() doesn't deselect the current selection. If this item is part of a single-selection list view, you have to deselect the current selection yourself.

Note

If possible, you should use BListView's versions of these functions (see BListView::Select(). They update the view and manage the selection for you.

SetEnabled() sets the list item's enabled state; IsEnabled() returns the state. A disabled item can't be selected by the user or by BListView::Select() , but it can be selected through BListItem::Select(). If an item is already selected, SetEnabled(false) doesn't deselect it.

After calling SetEnabled(), you must tell the owner list view to redraw the item (see BListView::InvalidateItem()).

Note that BListView doesn't provide smart versions of these functions (as it does for Select()).

These functions set and return the item's expanded state. This is only meaningful if the item is part of a BOutlineListView. The item is not automatically redrawn; you must tell the BOutlineListView to redraw the item (and its sublist) through BListView::InvalidateItem().

Note

If possible, you should use BOutlineListView's Expand() and Collapse() functions instead of SetExpanded(). The BOutlineListView functions redraw the affected part of the list for you.

These functions set and return the width and height of the item. The item's dimensions are adjusted when Update() is called.