Q3ListBoxItem Class
The Q3ListBoxItem class is the base class of all list box items. More...
Header: | #include <Q3ListBoxItem> |
Inherited By: |
Public Functions
Q3ListBoxItem(Q3ListBox * listbox = 0) | |
Q3ListBoxItem(Q3ListBox * listbox, Q3ListBoxItem * after) | |
virtual | ~Q3ListBoxItem() |
bool | current() const |
virtual int | height(const Q3ListBox * lb) const |
bool | isCurrent() const |
bool | isSelectable() const |
bool | isSelected() const |
Q3ListBox * | listBox() const |
Q3ListBoxItem * | next() const |
virtual const QPixmap * | pixmap() const |
Q3ListBoxItem * | prev() const |
virtual int | rtti() const |
bool | selected() const |
void | setSelectable(bool b) |
virtual QString | text() const |
virtual int | width(const Q3ListBox * lb) const |
Protected Functions
virtual void | paint(QPainter * p) = 0 |
void | setCustomHighlighting(bool b) |
virtual void | setText(const QString & text) |
Detailed Description
The Q3ListBoxItem class is the base class of all list box items.
This class is an abstract base class used for all list box items. If you need to insert customized items into a Q3ListBox you must inherit this class and reimplement paint(), height() and width().
See also Q3ListBox.
Member Function Documentation
Q3ListBoxItem::Q3ListBoxItem(Q3ListBox * listbox = 0)
Constructs an empty list box item in the list box listbox.
Q3ListBoxItem::Q3ListBoxItem(Q3ListBox * listbox, Q3ListBoxItem * after)
Constructs an empty list box item in the list box listbox and inserts it after the item after or at the beginning if after is 0.
[virtual]
Q3ListBoxItem::~Q3ListBoxItem()
Destroys the list box item.
bool Q3ListBoxItem::current() const
Use isCurrent() instead. Returns true if isCurrent() returns true.
[virtual]
int Q3ListBoxItem::height(const Q3ListBox * lb) const
Implement this function to return the height of your item. The lb parameter is the same as listBox() and is provided for convenience and compatibility.
The default implementation returns QApplication::globalStrut()'s height.
bool Q3ListBoxItem::isCurrent() const
Returns true if the item is the current item; otherwise returns false.
See also Q3ListBox::currentItem(), Q3ListBox::item(), and isSelected().
bool Q3ListBoxItem::isSelectable() const
Returns true if this item is selectable (the default); otherwise returns false.
See also setSelectable().
bool Q3ListBoxItem::isSelected() const
Returns true if the item is selected; otherwise returns false.
See also Q3ListBox::isSelected() and isCurrent().
Q3ListBox * Q3ListBoxItem::listBox() const
Returns a pointer to the list box containing this item.
Q3ListBoxItem * Q3ListBoxItem::next() const
Returns the item that comes after this in the list box. If this is the last item, 0 is returned.
See also prev().
[pure virtual protected]
void Q3ListBoxItem::paint(QPainter * p)
Implement this function to draw your item. The painter, p, is already open for painting.
See also height() and width().
[virtual]
const QPixmap * Q3ListBoxItem::pixmap() const
Returns the pixmap associated with the item, or 0 if there isn't one.
The default implementation returns 0.
Q3ListBoxItem * Q3ListBoxItem::prev() const
Returns the item which comes before this in the list box. If this is the first item, 0 is returned.
See also next().
[virtual]
int Q3ListBoxItem::rtti() const
Returns 0.
Make your derived classes return their own values for rtti(), and you can distinguish between listbox items. You should use values greater than 1000 preferably a large random number, to allow for extensions to this class.
bool Q3ListBoxItem::selected() const
Use isSelected() instead. Returns true if isSelected() returns true.
[protected]
void Q3ListBoxItem::setCustomHighlighting(bool b)
Defines whether the list box item is responsible for drawing itself in a highlighted state when being selected.
If b is false (the default), the list box will draw some default highlight indicator before calling paint().
See also isSelected() and paint().
void Q3ListBoxItem::setSelectable(bool b)
If b is true (the default) then this item can be selected by the user; otherwise this item cannot be selected by the user.
See also isSelectable().
[virtual protected]
void Q3ListBoxItem::setText(const QString & text)
Sets the text of the Q3ListBoxItem to text. This text is also used for sorting. The text is not shown unless explicitly drawn in paint().
See also text().
[virtual]
QString Q3ListBoxItem::text() const
Returns the text of the item. This text is also used for sorting.
See also setText().
[virtual]
int Q3ListBoxItem::width(const Q3ListBox * lb) const
Reimplement this function to return the width of your item. The lb parameter is the same as listBox() and is provided for convenience and compatibility.
The default implementation returns QApplication::globalStrut()'s width.
© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.