<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /tmp/qt-3.0-reggie-28534/qt-x11-free-3.0.2/src/widgets/qlistview.cpp:288 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QListViewItem Class</title>
<style type="text/css"><!--
h3.fn,span.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 Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped 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>QListViewItem Class Reference</h1>
<p>The QListViewItem class implements a list view item.
<a href="#details">More...</a>
<p><tt>#include <<a href="qlistview-h.html">qlistview.h</a>></tt>
<p>Inherits <a href="qt.html">Qt</a>.
<p>Inherited by <a href="qchecklistitem.html">QCheckListItem</a>.
<p><a href="qlistviewitem-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li><div class=fn><a href="#QListViewItem"><b>QListViewItem</b></a> ( QListView * parent )</div></li>
<li><div class=fn><a href="#QListViewItem-2"><b>QListViewItem</b></a> ( QListViewItem * parent )</div></li>
<li><div class=fn><a href="#QListViewItem-3"><b>QListViewItem</b></a> ( QListView * parent, QListViewItem * after )</div></li>
<li><div class=fn><a href="#QListViewItem-4"><b>QListViewItem</b></a> ( QListViewItem * parent, QListViewItem * after )</div></li>
<li><div class=fn><a href="#QListViewItem-5"><b>QListViewItem</b></a> ( QListView * parent, QString label1, QString label2 = QString::null, QString label3 = QString::null, QString label4 = QString::null, QString label5 = QString::null, QString label6 = QString::null, QString label7 = QString::null, QString label8 = QString::null )</div></li>
<li><div class=fn><a href="#QListViewItem-6"><b>QListViewItem</b></a> ( QListViewItem * parent, QString label1, QString label2 = QString::null, QString label3 = QString::null, QString label4 = QString::null, QString label5 = QString::null, QString label6 = QString::null, QString label7 = QString::null, QString label8 = QString::null )</div></li>
<li><div class=fn><a href="#QListViewItem-7"><b>QListViewItem</b></a> ( QListView * parent, QListViewItem * after, QString label1, QString label2 = QString::null, QString label3 = QString::null, QString label4 = QString::null, QString label5 = QString::null, QString label6 = QString::null, QString label7 = QString::null, QString label8 = QString::null )</div></li>
<li><div class=fn><a href="#QListViewItem-8"><b>QListViewItem</b></a> ( QListViewItem * parent, QListViewItem * after, QString label1, QString label2 = QString::null, QString label3 = QString::null, QString label4 = QString::null, QString label5 = QString::null, QString label6 = QString::null, QString label7 = QString::null, QString label8 = QString::null )</div></li>
<li><div class=fn>virtual <a href="#~QListViewItem"><b>~QListViewItem</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#insertItem"><b>insertItem</b></a> ( QListViewItem * newChild )</div></li>
<li><div class=fn>virtual void <a href="#takeItem"><b>takeItem</b></a> ( QListViewItem * item )</div></li>
<li><div class=fn>virtual void removeItem ( QListViewItem * item ) <em>(obsolete)</em></div></li>
<li><div class=fn>int <a href="#height"><b>height</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#invalidateHeight"><b>invalidateHeight</b></a> ()</div></li>
<li><div class=fn>int <a href="#totalHeight"><b>totalHeight</b></a> () const</div></li>
<li><div class=fn>virtual int <a href="#width"><b>width</b></a> ( const QFontMetrics & fm, const QListView * lv, int c ) const</div></li>
<li><div class=fn>void <a href="#widthChanged"><b>widthChanged</b></a> ( int c = -1 ) const</div></li>
<li><div class=fn>int <a href="#depth"><b>depth</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setText"><b>setText</b></a> ( int column, const QString & text )</div></li>
<li><div class=fn>virtual QString <a href="#text"><b>text</b></a> ( int column ) const</div></li>
<li><div class=fn>virtual void <a href="#setPixmap"><b>setPixmap</b></a> ( int column, const QPixmap & pm )</div></li>
<li><div class=fn>virtual const QPixmap * <a href="#pixmap"><b>pixmap</b></a> ( int column ) const</div></li>
<li><div class=fn>virtual QString <a href="#key"><b>key</b></a> ( int column, bool ascending ) const</div></li>
<li><div class=fn>virtual int <a href="#compare"><b>compare</b></a> ( QListViewItem * i, int col, bool ascending ) const</div></li>
<li><div class=fn>virtual void <a href="#sortChildItems"><b>sortChildItems</b></a> ( int column, bool ascending )</div></li>
<li><div class=fn>int <a href="#childCount"><b>childCount</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isOpen"><b>isOpen</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setOpen"><b>setOpen</b></a> ( bool o )</div></li>
<li><div class=fn>virtual void <a href="#setup"><b>setup</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#setSelected"><b>setSelected</b></a> ( bool s )</div></li>
<li><div class=fn>bool <a href="#isSelected"><b>isSelected</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#paintCell"><b>paintCell</b></a> ( QPainter * p, const QColorGroup & cg, int column, int width, int align )</div></li>
<li><div class=fn>virtual void <a href="#paintBranches"><b>paintBranches</b></a> ( QPainter * p, const QColorGroup & cg, int w, int y, int h )</div></li>
<li><div class=fn>virtual void <a href="#paintFocus"><b>paintFocus</b></a> ( QPainter * p, const QColorGroup & cg, const QRect & r )</div></li>
<li><div class=fn>QListViewItem * <a href="#firstChild"><b>firstChild</b></a> () const</div></li>
<li><div class=fn>QListViewItem * <a href="#nextSibling"><b>nextSibling</b></a> () const</div></li>
<li><div class=fn>QListViewItem * <a href="#parent"><b>parent</b></a> () const</div></li>
<li><div class=fn>QListViewItem * <a href="#itemAbove"><b>itemAbove</b></a> ()</div></li>
<li><div class=fn>QListViewItem * <a href="#itemBelow"><b>itemBelow</b></a> ()</div></li>
<li><div class=fn>int <a href="#itemPos"><b>itemPos</b></a> () const</div></li>
<li><div class=fn>QListView * <a href="#listView"><b>listView</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setSelectable"><b>setSelectable</b></a> ( bool enable )</div></li>
<li><div class=fn>bool <a href="#isSelectable"><b>isSelectable</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setExpandable"><b>setExpandable</b></a> ( bool enable )</div></li>
<li><div class=fn>bool <a href="#isExpandable"><b>isExpandable</b></a> () const</div></li>
<li><div class=fn>void <a href="#repaint"><b>repaint</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#sort"><b>sort</b></a> ()</div></li>
<li><div class=fn>void <a href="#moveItem"><b>moveItem</b></a> ( QListViewItem * after )</div></li>
<li><div class=fn>virtual void <a href="#setDragEnabled"><b>setDragEnabled</b></a> ( bool allow )</div></li>
<li><div class=fn>virtual void <a href="#setDropEnabled"><b>setDropEnabled</b></a> ( bool allow )</div></li>
<li><div class=fn>bool <a href="#dragEnabled"><b>dragEnabled</b></a> () const</div></li>
<li><div class=fn>bool <a href="#dropEnabled"><b>dropEnabled</b></a> () const</div></li>
<li><div class=fn>virtual bool <a href="#acceptDrop"><b>acceptDrop</b></a> ( const QMimeSource * mime ) const</div></li>
<li><div class=fn>void <a href="#setVisible"><b>setVisible</b></a> ( bool b )</div></li>
<li><div class=fn>bool <a href="#isVisible"><b>isVisible</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setRenameEnabled"><b>setRenameEnabled</b></a> ( int col, bool b )</div></li>
<li><div class=fn>bool <a href="#renameEnabled"><b>renameEnabled</b></a> ( int col ) const</div></li>
<li><div class=fn>virtual void <a href="#startRename"><b>startRename</b></a> ( int col )</div></li>
<li><div class=fn>virtual void <a href="#setEnabled"><b>setEnabled</b></a> ( bool b )</div></li>
<li><div class=fn>bool <a href="#isEnabled"><b>isEnabled</b></a> () const</div></li>
<li><div class=fn>virtual int <a href="#rtti"><b>rtti</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setMultiLinesEnabled"><b>setMultiLinesEnabled</b></a> ( bool b )</div></li>
<li><div class=fn>bool <a href="#multiLinesEnabled"><b>multiLinesEnabled</b></a> () const</div></li>
</ul>
<h2>Protected Members</h2>
<ul>
<li><div class=fn>virtual void <a href="#enforceSortOrder"><b>enforceSortOrder</b></a> () const</div></li>
<li><div class=fn>virtual void <a href="#setHeight"><b>setHeight</b></a> ( int height )</div></li>
<li><div class=fn>virtual void <a href="#activate"><b>activate</b></a> ()</div></li>
<li><div class=fn>bool <a href="#activatedPos"><b>activatedPos</b></a> ( QPoint & pos )</div></li>
<li><div class=fn>virtual void <a href="#dropped"><b>dropped</b></a> ( QDropEvent * e )</div></li>
<li><div class=fn>virtual void <a href="#dragEntered"><b>dragEntered</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#dragLeft"><b>dragLeft</b></a> ()</div></li>
<li><div class=fn>virtual void <a href="#okRename"><b>okRename</b></a> ( int col )</div></li>
<li><div class=fn>virtual void <a href="#cancelRename"><b>cancelRename</b></a> ( int col )</div></li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
The QListViewItem class implements a list view item.
<p> A list view item is a multi-column object capable of displaying
itself in a <a href="qlistview.html">QListView</a>. Its design has the following main goals:
<ul>
<li> Work quickly and well for <em>large</em> sets of data.
<li> Be easy to use in the simple case.
</ul>
<p> The easiest way to use QListViewItem is to construct one with a few
constant strings. This creates an item that is a child of <em>parent</em> with two fixed-content strings, and discards the pointer to
it:
<p> <pre>
(void) new QListViewItem( parent, "first column", "second column" );
</pre>
<p> This object will be deleted when <em>parent</em> is deleted, as for
<a href="qobject.html">QObject</a>s.
<p> The parent is either another QListViewItem or a QListView. If the
parent is a QListView, this item is a top-level item within that
QListView. If the parent is another QListViewItem, this item
becomes a child of that list view item.
<p> If you keep the pointer, you can set or change the texts using
<a href="#setText">setText</a>(), add pixmaps using <a href="#setPixmap">setPixmap</a>(), change its mode using
<a href="#setSelectable">setSelectable</a>(), <a href="#setSelected">setSelected</a>(), <a href="#setOpen">setOpen</a>() and <a href="#setExpandable">setExpandable</a>().
You'll also be able to change its height using <a href="#setHeight">setHeight</a>(), and
traverse the tree. There's no need to retain the pointer however,
since you can get a pointer to any QListViewItem in a <a href="qlistview.html">QListView</a>
using <a href="qlistview.html#selectedItem">QListView::selectedItem</a>(), <a href="qlistview.html#currentItem">QListView::currentItem</a>(),
<a href="qlistview.html#firstChild">QListView::firstChild</a>(), <a href="qlistview.html#lastItem">QListView::lastItem</a>(),
<a href="qlistview.html#findItem">QListView::findItem</a>().
<p> <a href="qchecklistitem.html">QCheckListItem</a>s are list view items that have a checkbox or
radio button and can be used in place of QListViewItems.
<p> You can traverse the tree as if it were a doubly-linked list using
<a href="#itemAbove">itemAbove</a>() and <a href="#itemBelow">itemBelow</a>(); they return pointers to the items
directly above and below this item on the screen (even if none of
the three are actually visible at the moment).
<p> You can also traverse it as a tree by using <a href="#parent">parent</a>(), <a href="#firstChild">firstChild</a>(), and
<a href="#nextSibling">nextSibling</a>().
<p> Example:
<pre>
QListViewItem * myChild = myItem->firstChild();
while( myChild ) {
doSomething( myChild );
myChild = myChild-><a href="#nextSibling">nextSibling</a>();
}
</pre>
<p> There is also an interator class to traverse a tree of list view items.
To iterate over all items of a list view, do the following:
<p> <pre>
<a href="qlistviewitemiterator.html">QListViewItemIterator</a> it( listview );
for ( ; it.<a href="qlistviewitemiterator.html#current">current</a>(); ++it )
doSomething( it.<a href="qlistviewitemiterator.html#current">current</a>() ); // it.<a href="qlistviewitemiterator.html#current">current</a>() is a QListViewItem*
</pre>
<p> Note that the order of the children will change when the sorting
order changes and is undefined if the items are not visible. You
can, however, call <a href="#enforceSortOrder">enforceSortOrder</a>() at any time; <a href="qlistview.html">QListView</a> will
always call it before it needs to show an item.
<p> Many programs will need to reimplement QListViewItem. The most
commonly reimplemented functions are:
<ul>
<li> <a href="#text">text</a>() returns the text in a column. Many subclasses will
compute that on the fly.
<li> <a href="#key">key</a>() is used for sorting. The default key() simply calls
text(), but judicious use of key can be used to sort by date, for
example (as <a href="qfiledialog.html">QFileDialog</a> does).
<li> <a href="#setup">setup</a>() is called before showing the item and whenever the font
changes, for example.
<li> <a href="#activate">activate</a>() is called whenever the user clicks on the item or
presses space when the item is the currently highlighted item.
</ul>
<p> Some subclasses call <a href="#setExpandable">setExpandable</a>(TRUE) even when they have no
children, and populate themselves when setup() or <a href="#setOpen">setOpen</a>(TRUE) is
called. The dirview/dirview.cpp example program uses this
technique to start up quickly: The files and subdirectories in a
directory aren't inserted into the tree until they're actually needed.
<p> <center><img src="qlistviewitems.png" alt="List View Items"></center>
<p> <p>See also <a href="qchecklistitem.html">QCheckListItem</a>, <a href="qlistview.html">QListView</a> and <a href="advanced.html">Advanced Widgets</a>.
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="QListViewItem"></a>QListViewItem::QListViewItem ( <a href="qlistview.html">QListView</a> * parent )
</h3>
Constructs a new top-level list view item in the <a href="qlistview.html">QListView</a> <em>parent</em>.
<h3 class=fn><a name="QListViewItem-2"></a>QListViewItem::QListViewItem ( <a href="qlistviewitem.html">QListViewItem</a> * parent )
</h3> Constructs a new list view item that is a child of <em>parent</em> and first
in the parent's list of children.
<h3 class=fn><a name="QListViewItem-3"></a>QListViewItem::QListViewItem ( <a href="qlistview.html">QListView</a> * parent, <a href="qlistviewitem.html">QListViewItem</a> * after )
</h3> Constructs an empty list view item that is a child of <em>parent</em>
and is after <em>after</em> in the parent's list of children. Since <em>parent</em> is a <a href="qlistview.html">QListView</a> the item will be a top-level item.
<h3 class=fn><a name="QListViewItem-4"></a>QListViewItem::QListViewItem ( <a href="qlistviewitem.html">QListViewItem</a> * parent, <a href="qlistviewitem.html">QListViewItem</a> * after )
</h3> Constructs an empty list view item that is a child of <em>parent</em>
and is after <em>after</em> in the parent's list of children.
<h3 class=fn><a name="QListViewItem-5"></a>QListViewItem::QListViewItem ( <a href="qlistview.html">QListView</a> * parent, <a href="qstring.html">QString</a> label1, <a href="qstring.html">QString</a> label2 = QString::null, <a href="qstring.html">QString</a> label3 = QString::null, <a href="qstring.html">QString</a> label4 = QString::null, <a href="qstring.html">QString</a> label5 = QString::null, <a href="qstring.html">QString</a> label6 = QString::null, <a href="qstring.html">QString</a> label7 = QString::null, <a href="qstring.html">QString</a> label8 = QString::null )
</h3> Constructs a new list view item in the <a href="qlistview.html">QListView</a> <em>parent</em>,
<em>parent</em>, with up to eight constant strings <em>label1</em>, <em>label2</em>,
<em>label3</em>, <em>label4</em>, <em>label5</em>, <em>label6</em>, <em>label7</em> and
<em>label8</em> defining its column contents.
<p> <p>See also <a href="#setText">setText</a>().
<h3 class=fn><a name="QListViewItem-6"></a>QListViewItem::QListViewItem ( <a href="qlistviewitem.html">QListViewItem</a> * parent, <a href="qstring.html">QString</a> label1, <a href="qstring.html">QString</a> label2 = QString::null, <a href="qstring.html">QString</a> label3 = QString::null, <a href="qstring.html">QString</a> label4 = QString::null, <a href="qstring.html">QString</a> label5 = QString::null, <a href="qstring.html">QString</a> label6 = QString::null, <a href="qstring.html">QString</a> label7 = QString::null, <a href="qstring.html">QString</a> label8 = QString::null )
</h3> Constructs a new list view item as a child of the QListViewItem
<em>parent</em> with optional constant strings <em>label1</em>, <em>label2</em>, <em>label3</em>, <em>label4</em>, <em>label5</em>, <em>label6</em>, <em>label7</em> and <em>label8</em> as
column contents.
<p> <p>See also <a href="#setText">setText</a>().
<h3 class=fn><a name="QListViewItem-7"></a>QListViewItem::QListViewItem ( <a href="qlistview.html">QListView</a> * parent, <a href="qlistviewitem.html">QListViewItem</a> * after, <a href="qstring.html">QString</a> label1, <a href="qstring.html">QString</a> label2 = QString::null, <a href="qstring.html">QString</a> label3 = QString::null, <a href="qstring.html">QString</a> label4 = QString::null, <a href="qstring.html">QString</a> label5 = QString::null, <a href="qstring.html">QString</a> label6 = QString::null, <a href="qstring.html">QString</a> label7 = QString::null, <a href="qstring.html">QString</a> label8 = QString::null )
</h3> Constructs a new list view item in the <a href="qlistview.html">QListView</a> <em>parent</em>
that is included after item <em>after</em> and can contain up to
eight column texts <em>label1</em>, <em>label2</em>, <em>label3</em>, <em>label4</em>, <em>label5</em>, <em>label6</em>, <em>label7</em> and<em>label8</em>.
<p> Note that the order is changed according to <a href="#key">QListViewItem::key</a>()
unless the list view's sorting is disabled using
<a href="qlistview.html#setSorting">QListView::setSorting</a>( -1 ).
<p> <p>See also <a href="#setText">setText</a>().
<h3 class=fn><a name="QListViewItem-8"></a>QListViewItem::QListViewItem ( <a href="qlistviewitem.html">QListViewItem</a> * parent, <a href="qlistviewitem.html">QListViewItem</a> * after, <a href="qstring.html">QString</a> label1, <a href="qstring.html">QString</a> label2 = QString::null, <a href="qstring.html">QString</a> label3 = QString::null, <a href="qstring.html">QString</a> label4 = QString::null, <a href="qstring.html">QString</a> label5 = QString::null, <a href="qstring.html">QString</a> label6 = QString::null, <a href="qstring.html">QString</a> label7 = QString::null, <a href="qstring.html">QString</a> label8 = QString::null )
</h3> Constructs a new list view item as a child of the QListViewItem
<em>parent</em>. It is inserted after item <em>after</em> and
may contain up to eight strings <em>label1</em>, <em>label2</em>, <em>label3</em>, <em>label4</em>, <em>label5</em>, <em>label6</em>, <em>label7</em> and <em>label8</em> as column
entries.
<p> Note that the order is changed according to <a href="#key">QListViewItem::key</a>()
unless the list view's sorting is disabled using
<a href="qlistview.html#setSorting">QListView::setSorting</a>( -1 ).
<p> <p>See also <a href="#setText">setText</a>().
<h3 class=fn><a name="~QListViewItem"></a>QListViewItem::~QListViewItem ()<tt> [virtual]</tt>
</h3> Destroys the item, deleting all its children and freeing up all
allocated resources.
<h3 class=fn>bool <a name="acceptDrop"></a>QListViewItem::acceptDrop ( const <a href="qmimesource.html">QMimeSource</a> * mime ) const<tt> [virtual]</tt>
</h3> Returns TRUE if the item can accept drops of type <a href="qmimesource.html">QMimeSource</a> <em>mime</em>;
otherwise returns FALSE.
<p> The default implementation does nothing and returns FALSE. A
subclass must reimplement this to accept drops.
<h3 class=fn>void <a name="activate"></a>QListViewItem::activate ()<tt> [virtual protected]</tt>
</h3>
This virtual function is called whenever the user clicks on this
item or presses Space on it.
<p> <p>See also <a href="#activatedPos">activatedPos</a>().
<p>Reimplemented in <a href="qchecklistitem.html#activate">QCheckListItem</a>.
<h3 class=fn>bool <a name="activatedPos"></a>QListViewItem::activatedPos ( <a href="qpoint.html">QPoint</a> & pos )<tt> [protected]</tt>
</h3>
When called from a reimplementation of <a href="#activate">activate</a>(), this function
gives information on how the item was activated. Otherwise the
behavior is undefined.
<p> If activate() was caused by a mouse press, the function sets <em>pos</em> to where the user clicked and returns TRUE; otherwise it returns
FALSE and does not change <em>pos</em>.
<p> <em>pos</em> is relative to the top-left corner of this item.
<p> We recommend not using this function; it is scheduled to become
obsolete.
<p> <p>See also <a href="#activate">activate</a>().
<h3 class=fn>void <a name="cancelRename"></a>QListViewItem::cancelRename ( int col )<tt> [virtual protected]</tt>
</h3> This function is called if the user cancels in-place renaming
of this item in column <em>col</em>.
<p> <p>See also <a href="#okRename">okRename</a>().
<h3 class=fn>int <a name="childCount"></a>QListViewItem::childCount () const
</h3>
<p> Returns how many children this item has.
<h3 class=fn>int <a name="compare"></a>QListViewItem::compare ( <a href="qlistviewitem.html">QListViewItem</a> * i, int col, bool ascending ) const<tt> [virtual]</tt>
</h3> Compares this listview item to <em>i</em> using the column <em>col</em> in <em>ascending</em> order. Returns -1 if this item is less than <em>i</em>, 0 if
they are equal and 1 if this item is greater than <em>i</em>.
<p> This function is used for sorting.
<p> The default implementation compares the item keys (<a href="#key">key</a>()) using
<a href="qstring.html#localeAwareCompare">QString::localeAwareCompare</a>(). A reimplementation may use different
values and a different comparison function. Here is a
reimplementation that uses plain Unicode comparison:
<p> <pre>
int MyListViewItem::compare( QListViewItem *i, int col,
bool ascending ) const
{
return key( col, ascending ).compare( i-><a href="#key">key</a>(col, ascending) );
}
</pre>
We don't recommend using <em>ascending</em> so your code can safely ignore it.
<p> <p>See also <a href="#key">key</a>(), <a href="qstring.html#localeAwareCompare">QString::localeAwareCompare</a>() and <a href="qstring.html#compare">QString::compare</a>().
<p>Example: <a href="ftpclient-example.html#x1039">network/ftpclient/ftpview.cpp</a>.
<h3 class=fn>int <a name="depth"></a>QListViewItem::depth () const
</h3>
Returns the depth of this item.
<p>Example: <a href="dirview-example.html#x1679">dirview/dirview.cpp</a>.
<h3 class=fn>bool <a name="dragEnabled"></a>QListViewItem::dragEnabled () const
</h3> Returns TRUE if this item can be dragged; otherwise returns FALSE.
<p> <p>See also <a href="#setDragEnabled">setDragEnabled</a>().
<h3 class=fn>void <a name="dragEntered"></a>QListViewItem::dragEntered ()<tt> [virtual protected]</tt>
</h3> This method is called when a drag entered the item's bounding
rectangle.
<p> The default implementation does nothing, subclasses may need to
reimplement this method.
<h3 class=fn>void <a name="dragLeft"></a>QListViewItem::dragLeft ()<tt> [virtual protected]</tt>
</h3> This method is called when a drag left the item's bounding
rectangle.
<p> The default implementation does nothing, subclasses may need to
reimplement this method.
<h3 class=fn>bool <a name="dropEnabled"></a>QListViewItem::dropEnabled () const
</h3> Returns TRUE if this item accepts drops; otherwise returns FALSE.
<p> <p>See also <a href="#setDropEnabled">setDropEnabled</a>() and <a href="#acceptDrop">acceptDrop</a>().
<h3 class=fn>void <a name="dropped"></a>QListViewItem::dropped ( <a href="qdropevent.html">QDropEvent</a> * e )<tt> [virtual protected]</tt>
</h3> This method is called when something was dropped on the item.
<em>e</em> contains all the information about the drop.
<p> The default implementation does nothing, subclasses may need to
reimplement this method.
<h3 class=fn>void <a name="enforceSortOrder"></a>QListViewItem::enforceSortOrder () const<tt> [virtual protected]</tt>
</h3> Makes sure that this object's children are sorted appropriately.
<p> This works only if every item from the root item down to
this item is already sorted.
<p> <p>See also <a href="#sortChildItems">sortChildItems</a>().
<h3 class=fn><a href="qlistviewitem.html">QListViewItem</a> * <a name="firstChild"></a>QListViewItem::firstChild () const
</h3>
Returns a pointer to the first (top) child of this item, or a null
pointer if this item has no children.
<p> Note that the children are not guaranteed to be sorted properly.
<a href="qlistview.html">QListView</a> and QListViewItem try to postpone or avoid sorting to the
greatest degree possible, in order to keep the user interface
snappy.
<p> <p>See also <a href="#nextSibling">nextSibling</a>().
<p>Example: <a href="checklists-example.html#x1871">checklists/checklists.cpp</a>.
<h3 class=fn>int <a name="height"></a>QListViewItem::height () const
</h3>
Returns the height of this item in pixels. This does not include
the height of any children; <a href="#totalHeight">totalHeight</a>() returns that.
<h3 class=fn>void <a name="insertItem"></a>QListViewItem::insertItem ( <a href="qlistviewitem.html">QListViewItem</a> * newChild )<tt> [virtual]</tt>
</h3>
Inserts <em>newChild</em> into this list view item's list of children.
You should not need to call this function; it is called
automatically by the constructor of <em>newChild</em>.
<h3 class=fn>void <a name="invalidateHeight"></a>QListViewItem::invalidateHeight ()<tt> [virtual]</tt>
</h3> Invalidates the cached total height of this item, including
all open children.
<p> <p>See also <a href="#setHeight">setHeight</a>(), <a href="#height">height</a>() and <a href="#totalHeight">totalHeight</a>().
<h3 class=fn>bool <a name="isEnabled"></a>QListViewItem::isEnabled () const
</h3> Returns TRUE if this item is enabled; otherwise returns FALSE.
<p> <p>See also <a href="#setEnabled">setEnabled</a>().
<h3 class=fn>bool <a name="isExpandable"></a>QListViewItem::isExpandable () const
</h3>
<p> Returns TRUE if this item is expandable even when it has no
children; otherwise returns FALSE.
<h3 class=fn>bool <a name="isOpen"></a>QListViewItem::isOpen () const
</h3>
<p> Returns TRUE if this list view item has children <em>and</em> they are
potentially visible. Returns FALSE if the item has no children or
they are hidden.
<p> <p>See also <a href="#setOpen">setOpen</a>().
<h3 class=fn>bool <a name="isSelectable"></a>QListViewItem::isSelectable () const
</h3>
<p> Returns TRUE if the item is selectable (as it is by default);
otherwise returns FALSE
<p> <p>See also <a href="#setSelectable">setSelectable</a>().
<h3 class=fn>bool <a name="isSelected"></a>QListViewItem::isSelected () const
</h3>
<p> Returns TRUE if this item is selected; otherwise returns FALSE.
<p> <p>See also <a href="#setSelected">setSelected</a>(), <a href="qlistview.html#setSelected">QListView::setSelected</a>() and <a href="qlistview.html#selectionChanged">QListView::selectionChanged</a>().
<p>Example: <a href="listviews-example.html#x1225">listviews/listviews.cpp</a>.
<h3 class=fn>bool <a name="isVisible"></a>QListViewItem::isVisible () const
</h3> Returns TRUE if the item is visible; otherwise returns FALSE.
<p> <p>See also <a href="#setVisible">setVisible</a>().
<h3 class=fn><a href="qlistviewitem.html">QListViewItem</a> * <a name="itemAbove"></a>QListViewItem::itemAbove ()
</h3>
Returns a pointer to the item immediately above this item on the
screen. This is usually the item's closest older sibling, but it may
also be its parent or its next older sibling's youngest child, or
something else if anyoftheabove->height() returns 0. Returns a null
pointer if there is no item immediately above this item.
<p> This function assumes that all parents of this item are open
(i.e. that this item is visible, or can be made visible by
scrolling).
<p> <p>See also <a href="#itemBelow">itemBelow</a>() and <a href="qlistview.html#itemRect">QListView::itemRect</a>().
<h3 class=fn><a href="qlistviewitem.html">QListViewItem</a> * <a name="itemBelow"></a>QListViewItem::itemBelow ()
</h3>
Returns a pointer to the item immediately below this item on the
screen. This is usually the item's eldest child, but it may also be
its next younger sibling, its parent's next younger sibling,
grandparent's, etc., or something else if anyoftheabove->height()
returns 0. Returns a null pointer if there is no item immediately
below this item.
<p> This function assumes that all parents of this item are open
(i.e. that this item is visible or can be made visible by
scrolling).
<p> <p>See also <a href="#itemAbove">itemAbove</a>() and <a href="qlistview.html#itemRect">QListView::itemRect</a>().
<p>Example: <a href="dirview-example.html#x1680">dirview/dirview.cpp</a>.
<h3 class=fn>int <a name="itemPos"></a>QListViewItem::itemPos () const
</h3> Returns the y coordinate of <em>this</em> item in the list view's
coordinate system. This function is normally much slower than
<a href="qlistview.html#itemAt">QListView::itemAt</a>(), but it works for all items whereas
QListView::itemAt() normally only works for items on the screen.
<p> <p>See also <a href="qlistview.html#itemAt">QListView::itemAt</a>(), <a href="qlistview.html#itemRect">QListView::itemRect</a>() and <a href="qlistview.html#itemPos">QListView::itemPos</a>().
<h3 class=fn><a href="qstring.html">QString</a> <a name="key"></a>QListViewItem::key ( int column, bool ascending ) const<tt> [virtual]</tt>
</h3>
<p> Returns a key that can be used for sorting by column <em>column</em>.
The default implementation returns <a href="#text">text</a>(). Derived classes may
also incorporate the order indicated by <em>ascending</em> into this
key, although this is not recommended.
<p> If you want to sort on non-alphabetical data, e.g. dates, numbers,
etc., reimplement <a href="#compare">compare</a>().
<p> <p>See also <a href="#compare">compare</a>() and <a href="#sortChildItems">sortChildItems</a>().
<h3 class=fn><a href="qlistview.html">QListView</a> * <a name="listView"></a>QListViewItem::listView () const
</h3> Returns a pointer to the list view containing this item.
<h3 class=fn>void <a name="moveItem"></a>QListViewItem::moveItem ( <a href="qlistviewitem.html">QListViewItem</a> * after )
</h3> Moves this item after the item <em>after</em>. This means it will get
the sibling exactly after the item <em>after</em>. To move an item in the
hierarchy, use <a href="#takeItem">takeItem</a>() and <a href="#insertItem">insertItem</a>().
<h3 class=fn>bool <a name="multiLinesEnabled"></a>QListViewItem::multiLinesEnabled () const
</h3>
Returns TRUE if the item can display multiple lines of text; otherwise
returns FALSE.
<h3 class=fn><a href="qlistviewitem.html">QListViewItem</a> * <a name="nextSibling"></a>QListViewItem::nextSibling () const
</h3>
<p> Returns a pointer to the sibling item below this item, or a
null pointer if there is no sibling item after this item.
<p> Note that the siblings are not guaranteed to be sorted properly.
<a href="qlistview.html">QListView</a> and QListViewItem try to postpone or avoid sorting to the
greatest degree possible, in order to keep the user interface
snappy.
<p> <p>See also <a href="#firstChild">firstChild</a>().
<h3 class=fn>void <a name="okRename"></a>QListViewItem::okRename ( int col )<tt> [virtual protected]</tt>
</h3> This function is called if the user presses Enter during in-place
renaming of the item in column <em>col</em>.
<p> <p>See also <a href="#cancelRename">cancelRename</a>().
<h3 class=fn>void <a name="paintBranches"></a>QListViewItem::paintBranches ( <a href="qpainter.html">QPainter</a> * p, const <a href="qcolorgroup.html">QColorGroup</a> & cg, int w, int y, int h )<tt> [virtual]</tt>
</h3> Paints a set of branches from this item to (some of) its children.
<p> Painter <em>p</em> is set up with clipping and translation so that you can
draw only in the rectangle you need to; <em>cg</em> is the color group to
use; the update rectangle is at (0, 0) and has size width <em>w</em> by
height <em>h</em>. The top of the rectangle you own is at <em>y</em> (which is
never greater than 0 but can be outside the window system's allowed
coordinate range).
<p> The update rectangle is in an undefined state when this function is
called; this function must draw on <em>all</em> of the pixels.
<p> <p>See also <a href="#paintCell">paintCell</a>() and <a href="qlistview.html#drawContentsOffset">QListView::drawContentsOffset</a>().
<h3 class=fn>void <a name="paintCell"></a>QListViewItem::paintCell ( <a href="qpainter.html">QPainter</a> * p, const <a href="qcolorgroup.html">QColorGroup</a> & cg, int column, int width, int align )<tt> [virtual]</tt>
</h3> This virtual function paints the contents of one column of an item
and aligns it as described by <em>align</em>.
<p> <em>p</em> is a <a href="qpainter.html">QPainter</a> open on the relevant paint device. <em>p</em> is
translated so (0, 0) is the top-left pixel in the cell and <em>width-1</em>,
<a href="#height">height</a>()-1 is the bottom-right pixel <em>in</em> the cell. The other
properties of <em>p</em> (pen, brush, etc) are undefined. <em>cg</em> is the
color group to use. <em>column</em> is the logical column number within
the item that is to be painted; 0 is the column which may contain a
tree.
<p> This function may use <a href="qlistview.html#itemMargin">QListView::itemMargin</a>() for readability
spacing on the left and right sides of data such as text,
and should honor <a href="#isSelected">isSelected</a>() and <a href="qlistview.html#allColumnsShowFocus">QListView::allColumnsShowFocus</a>().
<p> If you reimplement this function, you should also reimplement
<a href="#width">width</a>().
<p> The rectangle to be painted is in an undefined state when this
function is called, so you <em>must</em> draw on all the pixels. The
painter <em>p</em> has the right font on entry.
<p> <p>See also <a href="#paintBranches">paintBranches</a>() and <a href="qlistview.html#drawContentsOffset">QListView::drawContentsOffset</a>().
<p>Example: <a href="listviews-example.html#x1226">listviews/listviews.cpp</a>.
<p>Reimplemented in <a href="qchecklistitem.html#paintCell">QCheckListItem</a>.
<h3 class=fn>void <a name="paintFocus"></a>QListViewItem::paintFocus ( <a href="qpainter.html">QPainter</a> * p, const <a href="qcolorgroup.html">QColorGroup</a> & cg, const <a href="qrect.html">QRect</a> & r )<tt> [virtual]</tt>
</h3> Paints a focus indication on the rectangle <em>r</em> using painter <em>p</em>
and colors <em>cg</em>.
<p> <em>p</em> is already clipped.
<p> <p>See also <a href="#paintCell">paintCell</a>(), <a href="#paintBranches">paintBranches</a>() and <a href="qlistview.html#allColumnsShowFocus-prop">QListView::allColumnsShowFocus</a>.
<p>Reimplemented in <a href="qchecklistitem.html#paintFocus">QCheckListItem</a>.
<h3 class=fn><a href="qlistviewitem.html">QListViewItem</a> * <a name="parent"></a>QListViewItem::parent () const
</h3>
Returns a pointer to the parent of this item, or a null pointer if this
item has no parent.
<p> <p>See also <a href="#firstChild">firstChild</a>() and <a href="#nextSibling">nextSibling</a>().
<p>Example: <a href="dirview-example.html#x1681">dirview/dirview.cpp</a>.
<h3 class=fn>const <a href="qpixmap.html">QPixmap</a> * <a name="pixmap"></a>QListViewItem::pixmap ( int column ) const<tt> [virtual]</tt>
</h3> Returns a pointer to the pixmap for <em>column</em>, or a null pointer
if there is no pixmap for <em>column</em>.
<p> <p>See also <a href="#setText">setText</a>() and <a href="#setPixmap">setPixmap</a>().
<p>Examples: <a href="dirview-example.html#x1682">dirview/dirview.cpp</a> and <a href="ftpclient-example.html#x1040">network/ftpclient/ftpview.cpp</a>.
<h3 class=fn>void <a name="removeItem"></a>QListViewItem::removeItem ( <a href="qlistviewitem.html">QListViewItem</a> * item )<tt> [virtual]</tt>
</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> This function has been renamed <a href="#takeItem">takeItem</a>().
<h3 class=fn>bool <a name="renameEnabled"></a>QListViewItem::renameEnabled ( int col ) const
</h3> Returns TRUE if this item can be in-place renamed in
column <em>col</em>; otherwise returns FALSE.
<h3 class=fn>void <a name="repaint"></a>QListViewItem::repaint () const
</h3> Repaints this item on the screen if it is currently visible.
<p>Example: <a href="addressbook-example.html#x1982">addressbook/centralwidget.cpp</a>.
<h3 class=fn>int <a name="rtti"></a>QListViewItem::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 listview items. You should use values
greater than 1000 preferably a large random number, to allow for
extensions to this class.
<p>Reimplemented in <a href="qchecklistitem.html#rtti">QCheckListItem</a>.
<h3 class=fn>void <a name="setDragEnabled"></a>QListViewItem::setDragEnabled ( bool allow )<tt> [virtual]</tt>
</h3>
If <em>allow</em> is TRUE, the listview starts a drag (see
<a href="qlistview.html#dragObject">QListView::dragObject</a>()) when the user presses and moves the mouse
on this item.
<h3 class=fn>void <a name="setDropEnabled"></a>QListViewItem::setDropEnabled ( bool allow )<tt> [virtual]</tt>
</h3> If <em>allow</em> is TRUE, the listview accepts drops onto the item;
otherwise drops are not allowed..
<h3 class=fn>void <a name="setEnabled"></a>QListViewItem::setEnabled ( bool b )<tt> [virtual]</tt>
</h3>
If <em>b</em> is TRUE the item is enabled; otherwise it is disabled.
Disabled items are drawn grayed-out and are not accessable by the user.
<h3 class=fn>void <a name="setExpandable"></a>QListViewItem::setExpandable ( bool enable )<tt> [virtual]</tt>
</h3> Sets this item to be expandable even if it has no children if <em>enable</em> is TRUE, and to be expandable only if it has children if <em>enable</em> is FALSE (the default).
<p> The dirview example uses this in the canonical fashion. It checks
whether the directory is empty in <a href="#setup">setup</a>() and calls
<a href="#setExpandable">setExpandable</a>(TRUE) if not; in <a href="#setOpen">setOpen</a>() it reads the contents
of the directory and inserts items accordingly. This strategy means
that dirview can display the entire file system without reading very
much at startup.
<p> Note that root items are not expandable by the user unless
<a href="qlistview.html#setRootIsDecorated">QListView::setRootIsDecorated</a>() is set to TRUE.
<p> <p>See also <a href="#setSelectable">setSelectable</a>().
<h3 class=fn>void <a name="setHeight"></a>QListViewItem::setHeight ( int height )<tt> [virtual protected]</tt>
</h3> Sets this item's height to <em>height</em> pixels. This implicitly
changes <a href="#totalHeight">totalHeight</a>(), too.
<p> Note that a font change causes this height to be overwritten
unless you reimplement <a href="#setup">setup</a>().
<p> For best results in Windows style we suggest using an even number
of pixels.
<p> <p>See also <a href="#height">height</a>(), <a href="#totalHeight">totalHeight</a>() and <a href="#isOpen">isOpen</a>().
<h3 class=fn>void <a name="setMultiLinesEnabled"></a>QListViewItem::setMultiLinesEnabled ( bool b )<tt> [virtual]</tt>
</h3>
If <em>b</em> is TRUE items may contain multiple lines of text; otherwise
they may only contain a single line.
<h3 class=fn>void <a name="setOpen"></a>QListViewItem::setOpen ( bool o )<tt> [virtual]</tt>
</h3> Opens or closes an item, i.e. shows or hides an item's children.
<p> If <em>o</em> is TRUE all child items are shown initially. The
user can hide them by clicking the <em>-</em> icon to the left of
the item.
If <em>o</em> is FALSE, the children of this item are initially hidden.
The user can show them by clicking the <em>+</em> icon to the left of the
item.
<p> <p>See also <a href="#height">height</a>(), <a href="#totalHeight">totalHeight</a>() and <a href="#isOpen">isOpen</a>().
<p>Examples: <a href="checklists-example.html#x1872">checklists/checklists.cpp</a>, <a href="dirview-example.html#x1683">dirview/dirview.cpp</a>, <a href="dirview-example.html#x1712">dirview/main.cpp</a>, <a href="fileiconview-example.html#x1600">fileiconview/mainwindow.cpp</a> and <a href="tagreader-with-features-example.html#x38">xml/tagreader-with-features/structureparser.cpp</a>.
<h3 class=fn>void <a name="setPixmap"></a>QListViewItem::setPixmap ( int column, const <a href="qpixmap.html">QPixmap</a> & pm )<tt> [virtual]</tt>
</h3>
Sets the pixmap in column <em>column</em> to <em>pm</em>, if <em>pm</em> is non-null
and different from the current pixmap, and if <em>column</em> is
non-negative.
<p> <p>See also <a href="#pixmap">pixmap</a>() and <a href="#setText">setText</a>().
<p>Example: <a href="dirview-example.html#x1684">dirview/dirview.cpp</a>.
<h3 class=fn>void <a name="setRenameEnabled"></a>QListViewItem::setRenameEnabled ( int col, bool b )<tt> [virtual]</tt>
</h3> If <em>b</em> is TRUE, this item can be in-place renamed in the column
<em>col</em> by the user, otherwise it is not possible.
<h3 class=fn>void <a name="setSelectable"></a>QListViewItem::setSelectable ( bool enable )<tt> [virtual]</tt>
</h3> Sets this items to be selectable if <em>enable</em> is TRUE (the
default) or not to be selectable if <em>enable</em> is FALSE.
<p> The user is not able to select a non-selectable item using either
the keyboard or mouse. The application programmer still can, e.g.
using <a href="#setSelected">setSelected</a>().
<p> <p>See also <a href="#isSelectable">isSelectable</a>().
<p>Example: <a href="ftpclient-example.html#x1041">network/ftpclient/ftpview.cpp</a>.
<h3 class=fn>void <a name="setSelected"></a>QListViewItem::setSelected ( bool s )<tt> [virtual]</tt>
</h3>
If <em>s</em> is TRUE this item is selected; otherwise it is deselected.
<p> This function does not maintain any invariants or repaint anything --
<a href="qlistview.html#setSelected">QListView::setSelected</a>() does that.
<p> <p>See also <a href="#height">height</a>() and <a href="#totalHeight">totalHeight</a>().
<p>Example: <a href="addressbook-example.html#x1983">addressbook/centralwidget.cpp</a>.
<h3 class=fn>void <a name="setText"></a>QListViewItem::setText ( int column, const <a href="qstring.html">QString</a> & text )<tt> [virtual]</tt>
</h3> Sets the text in column <em>column</em> to <em>text</em>, if <em>column</em> is a
valid column number and <em>text</em> is different from the existing text.
<p> If <em>text()</em> has been reimplemented, this function may be a no-op.
<p> <p>See also <a href="#text">text</a>() and <a href="#key">key</a>().
<p>Examples: <a href="addressbook-example.html#x1984">addressbook/centralwidget.cpp</a> and <a href="outliner-example.html#x65">xml/outliner/outlinetree.cpp</a>.
<h3 class=fn>void <a name="setVisible"></a>QListViewItem::setVisible ( bool b )
</h3> If <em>b</em> is TRUE, the item is made visible; otherwise it is hidden.
<p> If the item is not visible, <a href="#itemAbove">itemAbove</a>() and <a href="#itemBelow">itemBelow</a>() will never
hit this item, although you still can reach it by using e.g. the
<a href="qlistviewitemiterator.html">QListViewItemIterator</a>.
<h3 class=fn>void <a name="setup"></a>QListViewItem::setup ()<tt> [virtual]</tt>
</h3> This virtual function is called before the first time <a href="qlistview.html">QListView</a>
needs to know the height or any other graphical attribute of this
object, and whenever the font, GUI style, or colors of the list view
change.
<p> The default calls <a href="#widthChanged">widthChanged</a>() and sets the item's height to the
height of a single line of text in the list view's font. (If you
use icons, multi-line text, etc., you will probably need to call
<a href="#setHeight">setHeight</a>() yourself or reimplement it.)
<p>Example: <a href="dirview-example.html#x1685">dirview/dirview.cpp</a>.
<h3 class=fn>void <a name="sort"></a>QListViewItem::sort ()<tt> [virtual]</tt>
</h3>
(Re)sorts all child items of this item using the last sorting
configuration (sort column and direction).
<p> <p>See also <a href="#enforceSortOrder">enforceSortOrder</a>().
<h3 class=fn>void <a name="sortChildItems"></a>QListViewItem::sortChildItems ( int column, bool ascending )<tt> [virtual]</tt>
</h3>
Sorts the children of this item using column <em>column</em>. This is
done in ascending order if <em>ascending</em> is TRUE and in descending
order if <em>ascending</em> is FALSE.
<p> Asks some of the children to sort their children. (<a href="qlistview.html">QListView</a> and
QListViewItem ensure that all on-screen objects are properly sorted
but may avoid or defer sorting other objects in order to be more
responsive.)
<p> <p>See also <a href="#key">key</a>() and <a href="#compare">compare</a>().
<h3 class=fn>void <a name="startRename"></a>QListViewItem::startRename ( int col )<tt> [virtual]</tt>
</h3> If in-place renaming of this item is enabled (see
<a href="#renameEnabled">renameEnabled</a>()), this function starts renaming the item in cloumn <em>col</em>,
by creating and initializing an edit box.
<h3 class=fn>void <a name="takeItem"></a>QListViewItem::takeItem ( <a href="qlistviewitem.html">QListViewItem</a> * item )<tt> [virtual]</tt>
</h3>
Removes <em>item</em> from this object's list of children and causes an update
of the screen display. The item is not deleted. You should normally not
need to call this function because <a href="#~QListViewItem">QListViewItem::~QListViewItem</a>() calls it.
<p> The normal way to delete an item is <tt>delete</tt>.
<p> If you need to move an item from one place in the hierarchy to
another you can use <a href="#takeItem">takeItem</a>() to remove the item from the list view
and then <a href="#insertItem">insertItem</a>() to put the item back in its new position.
<p> <b>Warning:</b> This function leaves <em>item</em> and its children in a state
where most member functions are unsafe. Only a few functions work
correctly on an item in this state, most notably insertItem(). The
functions that work on detached items are explicitly documented as
such.
<p> <p>See also <a href="#insertItem">QListViewItem::insertItem</a>().
<h3 class=fn><a href="qstring.html">QString</a> <a name="text"></a>QListViewItem::text ( int column ) const<tt> [virtual]</tt>
</h3> Returns the text in column <em>column</em>, or a
<a href="qstring.html#operator!">null string</a> if there
is no text in that column.
<p> <p>See also <a href="#key">key</a>() and <a href="#paintCell">paintCell</a>().
<p>Examples: <a href="addressbook-example.html#x1985">addressbook/centralwidget.cpp</a>, <a href="dirview-example.html#x1686">dirview/dirview.cpp</a> and <a href="ftpclient-example.html#x1042">network/ftpclient/ftpview.cpp</a>.
<h3 class=fn>int <a name="totalHeight"></a>QListViewItem::totalHeight () const
</h3> Returns the total height of this object, including any visible
children. This height is recomputed lazily and cached for as long
as possible.
<p> Functions which can affect the total height are, <a href="#setHeight">setHeight</a>() which is
used to set an item's height, <a href="#setOpen">setOpen</a>() to show or hide an item's
children, and <a href="#invalidateHeight">invalidateHeight</a>() to invalidate the cached height.
<p> <p>See also <a href="#height">height</a>().
<h3 class=fn>int <a name="width"></a>QListViewItem::width ( const <a href="qfontmetrics.html">QFontMetrics</a> & fm, const <a href="qlistview.html">QListView</a> * lv, int c ) const<tt> [virtual]</tt>
</h3>
Returns the number of pixels of width required to draw column <em>c</em>
of list view <em>lv</em>, using the metrics <em>fm</em> without cropping.
The list view containing this item may use
this information depending on the QListView::WidthMode settings
for the column.
<p> The default implementation returns the width of the bounding
rectangle of the text of column <em>c</em>.
<p> <p>See also <a href="#listView">listView</a>(), <a href="#widthChanged">widthChanged</a>(), <a href="qlistview.html#setColumnWidthMode">QListView::setColumnWidthMode</a>() and <a href="qlistview.html#itemMargin-prop">QListView::itemMargin</a>.
<h3 class=fn>void <a name="widthChanged"></a>QListViewItem::widthChanged ( int c = -1 ) const
</h3>
Call this function when the value of <a href="#width">width</a>() may have changed
for column <em>c</em>. Normally, you should call this if <a href="#text">text</a>(c) changes.
Passing -1 for <em>c</em> indicates that all columns may have changed.
For efficiency, you should do this if more than one
call to <a href="#widthChanged">widthChanged</a>() is required.
<p> <p>See also <a href="#width">width</a>().
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright © 1995-2001
<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 © 2001
<a href="http://www.trolltech.com">Trolltech</a><td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt version 3.0.2</div>
</table></div></address></body>
</html>
distrib
>
Mandriva
>
8.2
>
i586
>
media
>
contrib
>
by-pkgid
>
112b0974ad288f6cd55bf971ee6026a9
>
files
>
1494
