1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
'\" t
.TH QListBoxItem 3qt "18 March 2002" "Trolltech AS" \" -*- nroff -*-
.\" Copyright 1992-2001 Trolltech AS. All rights reserved. See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
QListBoxItem \- The base class of all list box items
.SH SYNOPSIS
\fC#include <qlistbox.h>\fR
.PP
Inherited by QListBoxText and QListBoxPixmap.
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBQListBoxItem\fR ( QListBox * listbox = 0 )"
.br
.ti -1c
.BI "\fBQListBoxItem\fR ( QListBox * listbox, QListBoxItem * after )"
.br
.ti -1c
.BI "virtual \fB~QListBoxItem\fR ()"
.br
.ti -1c
.BI "virtual QString \fBtext\fR () const"
.br
.ti -1c
.BI "virtual const QPixmap * \fBpixmap\fR () const"
.br
.ti -1c
.BI "virtual int \fBheight\fR ( const QListBox * lb ) const"
.br
.ti -1c
.BI "virtual int \fBwidth\fR ( const QListBox * lb ) const"
.br
.ti -1c
.BI "bool \fBisSelected\fR () const"
.br
.ti -1c
.BI "bool \fBisCurrent\fR () const"
.br
.ti -1c
.BI "bool selected () const \fI(obsolete)\fR"
.br
.ti -1c
.BI "bool current () const \fI(obsolete)\fR"
.br
.ti -1c
.BI "QListBox * \fBlistBox\fR () const"
.br
.ti -1c
.BI "void \fBsetSelectable\fR ( bool b )"
.br
.ti -1c
.BI "bool \fBisSelectable\fR () const"
.br
.ti -1c
.BI "QListBoxItem * \fBnext\fR () const"
.br
.ti -1c
.BI "QListBoxItem * \fBprev\fR () const"
.br
.ti -1c
.BI "virtual int \fBrtti\fR () const"
.br
.in -1c
.SS "Protected Members"
.in +1c
.ti -1c
.BI "virtual void \fBpaint\fR ( QPainter * p ) = 0"
.br
.ti -1c
.BI "virtual void \fBsetText\fR ( const QString & text )"
.br
.ti -1c
.BI "void \fBsetCustomHighlighting\fR ( bool b )"
.br
.in -1c
.SH DESCRIPTION
The QListBoxItem class is the base class of all list box items.
.PP
This class is an abstract base class used for all list box items. If you need to insert customized items into a QListBox you must inherit this class and reimplement paint(), height() and width().
.PP
See also QListBox and Advanced Widgets.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QListBoxItem::QListBoxItem ( QListBox * listbox = 0 )"
Constructs an empty list box item in the list box \fIlistbox\fR.
.SH "QListBoxItem::QListBoxItem ( QListBox * listbox, QListBoxItem * after )"
Constructs an empty list box item in the list box \fIlistbox\fR and inserts it after the item \fIafter\fR. If \fIafter\fR is 0, the item is inserted at the beginning.
.SH "QListBoxItem::~QListBoxItem ()\fC [virtual]\fR"
Destroys the list box item.
.SH "bool QListBoxItem::current () const"
\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code.
.SH "int QListBoxItem::height ( const QListBox * lb ) const\fC [virtual]\fR"
Implement this function to return the height of your item. The \fIlb\fR parameter is the same as listBox() and is provided for convenience and compatibility.
.PP
See also paint() and width().
.PP
Reimplemented in QListBoxText and QListBoxPixmap.
.SH "bool QListBoxItem::isCurrent () const"
Returns TRUE if the item is the current item; otherwise returns FALSE.
.PP
See also QListBox::currentItem, QListBox::item() and isSelected().
.SH "bool QListBoxItem::isSelectable () const"
Returns TRUE if this item is selectable; otherwise returns FALSE.
.PP
See also setSelectable().
.SH "bool QListBoxItem::isSelected () const"
Returns TRUE if the item is selected; otherwise returns FALSE.
.PP
See also QListBox::isSelected() and isCurrent().
.PP
Example: listboxcombo/listboxcombo.cpp.
.SH "QListBox * QListBoxItem::listBox () const"
Returns a pointer to the list box containing this item.
.SH "QListBoxItem * QListBoxItem::next () const"
Returns the item that comes after this in the list box. If this is the last item, a null pointer is returned.
.PP
See also prev().
.SH "void QListBoxItem::paint ( QPainter * p )\fC [pure virtual protected]\fR"
Implement this function to draw your item. You will need to pass the QPainter that will draw the item in \fIp\fR.
.PP
See also height() and width().
.PP
Example: listboxcombo/listboxcombo.cpp.
.PP
Reimplemented in QListBoxText and QListBoxPixmap.
.SH "const QPixmap * QListBoxItem::pixmap () const\fC [virtual]\fR"
Returns the pixmap associated with the item, if any.
.PP
The default implementation returns a null pointer.
.PP
Example: listboxcombo/listboxcombo.cpp.
.PP
Reimplemented in QListBoxPixmap.
.SH "QListBoxItem * QListBoxItem::prev () const"
Returns the item which comes before this in the list box. If this is the first item, a null pointer is returned.
.PP
See also next().
.SH "int QListBoxItem::rtti () const\fC [virtual]\fR"
Returns 0.
.PP
Although often frowned upon by purists, Run Time Type Identification is very useful in this case, as it allows a QListBox to be an efficient indexed storage mechanism.
.PP
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.
.SH "bool QListBoxItem::selected () const"
\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code.
.SH "void QListBoxItem::setCustomHighlighting ( bool b )\fC [protected]\fR"
Defines whether the list box item is responsible for drawing itself in a highlighted state when being selected.
.PP
If \fIb\fR is FALSE (the default), the list box will draw some default highlight indicator before calling paint().
.PP
See also selected() and paint().
.SH "void QListBoxItem::setSelectable ( bool b )"
If \fIb\fR is TRUE then this item can be selected by the user; otherwise this item cannot be selected by the user.
.PP
See also isSelectable().
.SH "void QListBoxItem::setText ( const QString & text )\fC [virtual protected]\fR"
Sets the text of the QListBoxItem to \fItext\fR. This \fItext\fR is also used for sorting. The text is not shown unless explicitly drawn in paint().
.PP
See also text().
.SH "QString QListBoxItem::text () const\fC [virtual]\fR"
Returns the text of the item. This text is also used for sorting.
.PP
See also setText().
.PP
Example: listboxcombo/listboxcombo.cpp.
.SH "int QListBoxItem::width ( const QListBox * lb ) const\fC [virtual]\fR"
Implement this function to return the width of your item. The \fIlb\fR parameter is the same as listBox() and is provided for convenience and compatibility.
.PP
See also paint() and height().
.PP
Reimplemented in QListBoxText and QListBoxPixmap.
.SH "SEE ALSO"
.BR http://doc.trolltech.com/qlistboxitem.html
.BR http://www.trolltech.com/faq/tech.html
.SH COPYRIGHT
Copyright 1992-2001 Trolltech AS, http://www.trolltech.com. See the
license file included in the distribution for a complete license
statement.
.SH AUTHOR
Generated automatically from the source code.
.SH BUGS
If you find a bug in Qt, please report it as described in
.BR http://doc.trolltech.com/bughowto.html .
Good bug reports help us to help you. Thank you.
.P
The definitive Qt documentation is provided in HTML format; it is
located at $QTDIR/doc/html and can be read using Qt Assistant or with
a web browser. This man page is provided as a convenience for those
users who prefer man pages, although this format is not officially
supported by Trolltech.
.P
If you find errors in this manual page, please report them to
.BR qt-bugs@trolltech.com .
Please include the name of the manual page (qlistboxitem.3qt) and the Qt
version (3.0.3).
|
