QCheckListItem(3qt)QCheckListItem(3qt)NAME
QCheckListItem - Implements checkable list view items
#include <qlistview.h>
Inherits QListViewItem.
Public Members
enum Type { RadioButton, CheckBox, Controller }
QCheckListItem ( QCheckListItem * parent, const QString &
text, Type = Controller )
QCheckListItem ( QListViewItem * parent, const QString &
text, Type = Controller )
QCheckListItem ( QListView * parent, const QString & text,
Type = Controller )
QCheckListItem ( QListViewItem * parent, const QString &
text, const QPixmap & )
QCheckListItem ( QListView * parent, const QString & text,
const QPixmap & )
~QCheckListItem ()
virtual void paintCell ( QPainter *, const QColorGroup &
cg, int column, int width, int alignment )
virtual void paintFocus ( QPainter *, const QColorGroup &
cg, const QRect & r )
virtual void setup ()
virtual void setOn ( bool )
bool isOn () const
Type type () const
QString text () const
void setEnabled ( bool b )
bool isEnabled () const
Protected Members
virtual void activate ()
void turnOffChild ()
virtual void stateChange ( bool )
DESCRIPTION
The QCheckListItem class implements checkable list view
items.
There are three types of check list items: CheckBox,
RadioButton and Controller.
Checkboxes may be inserted at top level in the list view.
A radio button must be child of a controller.
Member Type Documentation
QCheckListItem::Type
This enum type defines the modes in which a QCheckListItem
can be:
Trolltech AS 13 June 2001 1
QCheckListItem(3qt)QCheckListItem(3qt)
RadioButton -
CheckBox -
Controller -
MEMBER FUNCTION DOCUMENTATIONQCheckListItem::QCheckListItem ( QListView * parent, const
QString & text, Type tt = Controller )
Constructs a checkable item with parent parent, text text
and type tt. Note that tt must not be RadioButton, if so
it will not toggle.
QCheckListItem::QCheckListItem ( QListView * parent, const
QString & text, const QPixmap & p )
Constructs a Controller item with parent parent, text text
and pixmap p.
QCheckListItem::QCheckListItem ( QListViewItem * parent, const
QString & text, Type tt = Controller )
Constructs a checkable item with parent parent, text text
and type tt. Note that this item must not be a a
RadioButton. Radio buttons must be children on a
Controller.
QCheckListItem::QCheckListItem ( QListViewItem * parent, const
QString & text, const QPixmap & p )
Constructs a Controller item with parent parent, text text
and pixmap p.
QCheckListItem::QCheckListItem ( QCheckListItem * parent, const
QString & text, Type tt = Controller )
Constructs a checkable item with parent parent, text text
and type tt. Note that a RadioButton must be child of a
Controller, otherwise it will not toggle.
QCheckListItem::~QCheckListItem ()
Destroys the item, deleting all its children, freeing up
all allocated resources.
void QCheckListItem::activate () [virtual protected]
Toggle checkbox, or set radio button on.
Reimplemented from QListViewItem.
bool QCheckListItem::isEnabled () const
Retuns whether the item is enabled or disabled.
See also setEnabled().
bool QCheckListItem::isOn () const
Returns TRUE if this item is toggled on, FALSE otherwise.
Trolltech AS 13 June 2001 2
QCheckListItem(3qt)QCheckListItem(3qt)void QCheckListItem::paintBranches ( QPainter * p, const
QColorGroup & g, int w, int y, int h, GUIStyle s )
[virtual protected]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QListViewItem.
void QCheckListItem::paintCell ( QPainter * p, const QColorGroup
& cg, int column, int width, int align ) [virtual]
Paints this item.
Reimplemented from QListViewItem.
void QCheckListItem::paintFocus ( QPainter * p, const QColorGroup
& cg, const QRect & r ) [virtual]
Draws the focus rectangle.
void QCheckListItem::setEnabled ( bool b )
Enables/Disables the item depending on what you pass as b
parameter. If the item is disabled, the user can't change
the state (see setOn()/isOn()) of the item.
void QCheckListItem::setOn ( bool b ) [virtual]
Sets this button on if b is TRUE, off otherwise. Maintains
radio button exclusivity.
void QCheckListItem::setup () [virtual]
Performs setup.
Reimplemented from QListViewItem.
void QCheckListItem::stateChange ( bool ) [virtual protected]
This virtual function is called when the item changes its
on/off state.
QString QCheckListItem::text () const
Returns the text of this item.
QString QCheckListItem::text ( int n ) const [virtual]
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QListViewItem.
void QCheckListItem::turnOffChild () [protected]
If this is a Controller that has RadioButton children,
turn off the child that is on.
QCheckListItem::Type QCheckListItem::type() const
Returns the type of this item.
int QCheckListItem::width ( const QFontMetrics & fm, const
QListView * lv, int column ) const [virtual]
Trolltech AS 13 June 2001 3
QCheckListItem(3qt)QCheckListItem(3qt)
Reimplemented for internal reasons; the API is not
affected.
Reimplemented from QListViewItem.
SEE ALSO
http://doc.trolltech.com/qchecklistitem.html
http://www.trolltech.com/faq/tech.html
COPYRIGHT
Copyright 1992-2001 Trolltech AS,
http://www.trolltech.com. See the license file included
in the distribution for a complete license statement.
AUTHOR
Generated automatically from the source code.
BUGS
If you find a bug in Qt, please report it as described in
http://doc.trolltech.com/bughowto.html. Good bug reports
make our job much simpler. Thank you.
In case of content or formattting problems with this
manual page, please report them to qt-bugs@trolltech.com.
Please include the name of the manual page
(qchecklistitem.3qt) and the Qt version (2.3.1).
Trolltech AS 13 June 2001 4
