You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
qt3/doc/html/qlistboxitem.html

218 lines
11 KiB

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/widgets/qlistbox.cpp:160 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QListBoxItem Class</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">Home</font></a>
| <a href="classes.html">
<font color="#004faf">All&nbsp;Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped&nbsp;Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QListBoxItem Class Reference</h1>
<p>The QListBoxItem class is the base class of all list box items.
<a href="#details">More...</a>
<p><tt>#include &lt;<a href="qlistbox-h.html">qlistbox.h</a>&gt;</tt>
<p>Inherited by <a href="qlistboxtext.html">QListBoxText</a> and <a href="qlistboxpixmap.html">QListBoxPixmap</a>.
<p><a href="qlistboxitem-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn><a href="#QListBoxItem"><b>QListBoxItem</b></a> ( QListBox&nbsp;*&nbsp;listbox = 0 )</li>
<li class=fn><a href="#QListBoxItem-2"><b>QListBoxItem</b></a> ( QListBox&nbsp;*&nbsp;listbox, QListBoxItem&nbsp;*&nbsp;after )</li>
<li class=fn>virtual <a href="#~QListBoxItem"><b>~QListBoxItem</b></a> ()</li>
<li class=fn>virtual QString <a href="#text"><b>text</b></a> () const</li>
<li class=fn>virtual const QPixmap * <a href="#pixmap"><b>pixmap</b></a> () const</li>
<li class=fn>virtual int <a href="#height"><b>height</b></a> ( const&nbsp;QListBox&nbsp;*&nbsp;lb ) const</li>
<li class=fn>virtual int <a href="#width"><b>width</b></a> ( const&nbsp;QListBox&nbsp;*&nbsp;lb ) const</li>
<li class=fn>bool <a href="#isSelected"><b>isSelected</b></a> () const</li>
<li class=fn>bool <a href="#isCurrent"><b>isCurrent</b></a> () const</li>
<li class=fn>bool selected () const &nbsp;<em>(obsolete)</em></li>
<li class=fn>bool current () const &nbsp;<em>(obsolete)</em></li>
<li class=fn>QListBox * <a href="#listBox"><b>listBox</b></a> () const</li>
<li class=fn>void <a href="#setSelectable"><b>setSelectable</b></a> ( bool&nbsp;b )</li>
<li class=fn>bool <a href="#isSelectable"><b>isSelectable</b></a> () const</li>
<li class=fn>QListBoxItem * <a href="#next"><b>next</b></a> () const</li>
<li class=fn>QListBoxItem * <a href="#prev"><b>prev</b></a> () const</li>
<li class=fn>virtual int <a href="#rtti"><b>rtti</b></a> () const</li>
</ul>
<h2>Protected Members</h2>
<ul>
<li class=fn>virtual void <a href="#paint"><b>paint</b></a> ( QPainter&nbsp;*&nbsp;p ) = 0</li>
<li class=fn>virtual void <a href="#setText"><b>setText</b></a> ( const&nbsp;QString&nbsp;&amp;&nbsp;text )</li>
<li class=fn>void <a href="#setCustomHighlighting"><b>setCustomHighlighting</b></a> ( bool&nbsp;b )</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
The QListBoxItem class is the base class of all list box items.
<p> This class is an abstract base class used for all list box items.
If you need to insert customized items into a <a href="qlistbox.html">QListBox</a> you must
inherit this class and reimplement <a href="#paint">paint</a>(), <a href="#height">height</a>() and <a href="#width">width</a>().
<p> <p>See also <a href="qlistbox.html">QListBox</a>.
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="QListBoxItem"></a>QListBoxItem::QListBoxItem ( <a href="qlistbox.html">QListBox</a>&nbsp;*&nbsp;listbox = 0 )
</h3>
Constructs an empty list box item in the list box <em>listbox</em>.
<h3 class=fn><a name="QListBoxItem-2"></a>QListBoxItem::QListBoxItem ( <a href="qlistbox.html">QListBox</a>&nbsp;*&nbsp;listbox, <a href="qlistboxitem.html">QListBoxItem</a>&nbsp;*&nbsp;after )
</h3>
Constructs an empty list box item in the list box <em>listbox</em> and
inserts it after the item <em>after</em> or at the beginning if <em>after</em>
is 0.
<h3 class=fn><a name="~QListBoxItem"></a>QListBoxItem::~QListBoxItem ()<tt> [virtual]</tt>
</h3>
Destroys the list box item.
<h3 class=fn>bool <a name="current"></a>QListBoxItem::current () const
</h3>
<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
<p>
<h3 class=fn>int <a name="height"></a>QListBoxItem::height ( const&nbsp;<a href="qlistbox.html">QListBox</a>&nbsp;*&nbsp;lb ) const<tt> [virtual]</tt>
</h3>
<p> Implement this function to return the height of your item. The <em>lb</em> parameter is the same as <a href="#listBox">listBox</a>() and is provided for
convenience and compatibility.
<p> The default implementation returns
<a href="qapplication.html#globalStrut">QApplication::globalStrut</a>()'s height.
<p> <p>See also <a href="#paint">paint</a>() and <a href="#width">width</a>().
<p>Reimplemented in <a href="qlistboxtext.html#height">QListBoxText</a> and <a href="qlistboxpixmap.html#height">QListBoxPixmap</a>.
<h3 class=fn>bool <a name="isCurrent"></a>QListBoxItem::isCurrent () const
</h3>
Returns TRUE if the item is the current item; otherwise returns
FALSE.
<p> <p>See also <a href="qlistbox.html#currentItem-prop">QListBox::currentItem</a>, <a href="qlistbox.html#item">QListBox::item</a>(), and <a href="#isSelected">isSelected</a>().
<h3 class=fn>bool <a name="isSelectable"></a>QListBoxItem::isSelectable () const
</h3>
Returns TRUE if this item is selectable (the default); otherwise
returns FALSE.
<p> <p>See also <a href="#setSelectable">setSelectable</a>().
<h3 class=fn>bool <a name="isSelected"></a>QListBoxItem::isSelected () const
</h3>
<p> Returns TRUE if the item is selected; otherwise returns FALSE.
<p> <p>See also <a href="qlistbox.html#isSelected">QListBox::isSelected</a>() and <a href="#isCurrent">isCurrent</a>().
<p>Example: <a href="listboxcombo-example.html#x1409">listboxcombo/listboxcombo.cpp</a>.
<h3 class=fn><a href="qlistbox.html">QListBox</a>&nbsp;* <a name="listBox"></a>QListBoxItem::listBox () const
</h3>
Returns a pointer to the list box containing this item.
<h3 class=fn><a href="qlistboxitem.html">QListBoxItem</a>&nbsp;* <a name="next"></a>QListBoxItem::next () const
</h3>
Returns the item that comes after this in the list box. If this is
the last item, 0 is returned.
<p> <p>See also <a href="#prev">prev</a>().
<h3 class=fn>void <a name="paint"></a>QListBoxItem::paint ( <a href="qpainter.html">QPainter</a>&nbsp;*&nbsp;p )<tt> [pure virtual protected]</tt>
</h3>
<p> Implement this function to draw your item. The painter, <em>p</em>, is
already open for painting.
<p> <p>See also <a href="#height">height</a>() and <a href="#width">width</a>().
<p>Example: <a href="listboxcombo-example.html#x1410">listboxcombo/listboxcombo.cpp</a>.
<p>Reimplemented in <a href="qlistboxtext.html#paint">QListBoxText</a> and <a href="qlistboxpixmap.html#paint">QListBoxPixmap</a>.
<h3 class=fn>const&nbsp;<a href="qpixmap.html">QPixmap</a>&nbsp;* <a name="pixmap"></a>QListBoxItem::pixmap () const<tt> [virtual]</tt>
</h3>
Returns the pixmap associated with the item, or 0 if there isn't
one.
<p> The default implementation returns 0.
<p>Example: <a href="listboxcombo-example.html#x1411">listboxcombo/listboxcombo.cpp</a>.
<p>Reimplemented in <a href="qlistboxpixmap.html#pixmap">QListBoxPixmap</a>.
<h3 class=fn><a href="qlistboxitem.html">QListBoxItem</a>&nbsp;* <a name="prev"></a>QListBoxItem::prev () const
</h3>
Returns the item which comes before this in the list box. If this
is the first item, 0 is returned.
<p> <p>See also <a href="#next">next</a>().
<h3 class=fn>int <a name="rtti"></a>QListBoxItem::rtti () const<tt> [virtual]</tt>
</h3>
Returns 0.
<p> Make your derived classes return their own values for <a href="#rtti">rtti</a>(), 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.
<h3 class=fn>bool <a name="selected"></a>QListBoxItem::selected () const
</h3>
<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
<p>
<h3 class=fn>void <a name="setCustomHighlighting"></a>QListBoxItem::setCustomHighlighting ( bool&nbsp;b )<tt> [protected]</tt>
</h3>
Defines whether the list box item is responsible for drawing
itself in a highlighted state when being selected.
<p> If <em>b</em> is FALSE (the default), the list box will draw some
default highlight indicator before calling <a href="#paint">paint</a>().
<p> <p>See also <a href="#selected">selected</a>() and <a href="#paint">paint</a>().
<h3 class=fn>void <a name="setSelectable"></a>QListBoxItem::setSelectable ( bool&nbsp;b )
</h3>
If <em>b</em> is TRUE (the default) then this item can be selected by
the user; otherwise this item cannot be selected by the user.
<p> <p>See also <a href="#isSelectable">isSelectable</a>().
<h3 class=fn>void <a name="setText"></a>QListBoxItem::setText ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;text )<tt> [virtual protected]</tt>
</h3>
<p> Sets the text of the QListBoxItem to <em>text</em>. This <em>text</em> is also
used for sorting. The text is not shown unless explicitly drawn in
<a href="#paint">paint</a>().
<p> <p>See also <a href="#text">text</a>().
<h3 class=fn><a href="qstring.html">QString</a> <a name="text"></a>QListBoxItem::text () const<tt> [virtual]</tt>
</h3>
Returns the text of the item. This text is also used for sorting.
<p> <p>See also <a href="#setText">setText</a>().
<p>Example: <a href="listboxcombo-example.html#x1412">listboxcombo/listboxcombo.cpp</a>.
<h3 class=fn>int <a name="width"></a>QListBoxItem::width ( const&nbsp;<a href="qlistbox.html">QListBox</a>&nbsp;*&nbsp;lb ) const<tt> [virtual]</tt>
</h3>
<p> Reimplement this function to return the width of your item. The <em>lb</em> parameter is the same as <a href="#listBox">listBox</a>() and is provided for
convenience and compatibility.
<p> The default implementation returns
<a href="qapplication.html#globalStrut">QApplication::globalStrut</a>()'s width.
<p> <p>See also <a href="#paint">paint</a>() and <a href="#height">height</a>().
<p>Reimplemented in <a href="qlistboxtext.html#width">QListBoxText</a> and <a href="qlistboxpixmap.html#width">QListBoxPixmap</a>.
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright &copy; 1995-2007
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt 3.3.8</div>
</table></div></address></body>
</html>