diff options
Diffstat (limited to 'doc/html/qlistviewitem.html')
| -rw-r--r-- | doc/html/qlistviewitem.html | 809 |
1 files changed, 809 insertions, 0 deletions
diff --git a/doc/html/qlistviewitem.html b/doc/html/qlistviewitem.html new file mode 100644 index 0000000..e712b48 --- /dev/null +++ b/doc/html/qlistviewitem.html @@ -0,0 +1,809 @@ +<!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/qlistview.cpp:370 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>QListViewItem 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 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 class=fn><a href="#QListViewItem"><b>QListViewItem</b></a> ( QListView * parent )</li> +<li class=fn><a href="#QListViewItem-2"><b>QListViewItem</b></a> ( QListViewItem * parent )</li> +<li class=fn><a href="#QListViewItem-3"><b>QListViewItem</b></a> ( QListView * parent, QListViewItem * after )</li> +<li class=fn><a href="#QListViewItem-4"><b>QListViewItem</b></a> ( QListViewItem * parent, QListViewItem * after )</li> +<li 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 )</li> +<li 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 )</li> +<li 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 )</li> +<li 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 )</li> +<li class=fn>virtual <a href="#~QListViewItem"><b>~QListViewItem</b></a> ()</li> +<li class=fn>virtual void <a href="#insertItem"><b>insertItem</b></a> ( QListViewItem * newChild )</li> +<li class=fn>virtual void <a href="#takeItem"><b>takeItem</b></a> ( QListViewItem * item )</li> +<li class=fn>virtual void removeItem ( QListViewItem * item ) <em>(obsolete)</em></li> +<li class=fn>int <a href="#height"><b>height</b></a> () const</li> +<li class=fn>virtual void <a href="#invalidateHeight"><b>invalidateHeight</b></a> ()</li> +<li class=fn>int <a href="#totalHeight"><b>totalHeight</b></a> () const</li> +<li class=fn>virtual int <a href="#width"><b>width</b></a> ( const QFontMetrics & fm, const QListView * lv, int c ) const</li> +<li class=fn>void <a href="#widthChanged"><b>widthChanged</b></a> ( int c = -1 ) const</li> +<li class=fn>int <a href="#depth"><b>depth</b></a> () const</li> +<li class=fn>virtual void <a href="#setText"><b>setText</b></a> ( int column, const QString & text )</li> +<li class=fn>virtual QString <a href="#text"><b>text</b></a> ( int column ) const</li> +<li class=fn>virtual void <a href="#setPixmap"><b>setPixmap</b></a> ( int column, const QPixmap & pm )</li> +<li class=fn>virtual const QPixmap * <a href="#pixmap"><b>pixmap</b></a> ( int column ) const</li> +<li class=fn>virtual QString <a href="#key"><b>key</b></a> ( int column, bool ascending ) const</li> +<li class=fn>virtual int <a href="#compare"><b>compare</b></a> ( QListViewItem * i, int col, bool ascending ) const</li> +<li class=fn>virtual void <a href="#sortChildItems"><b>sortChildItems</b></a> ( int column, bool ascending )</li> +<li class=fn>int <a href="#childCount"><b>childCount</b></a> () const</li> +<li class=fn>bool <a href="#isOpen"><b>isOpen</b></a> () const</li> +<li class=fn>virtual void <a href="#setOpen"><b>setOpen</b></a> ( bool o )</li> +<li class=fn>virtual void <a href="#setup"><b>setup</b></a> ()</li> +<li class=fn>virtual void <a href="#setSelected"><b>setSelected</b></a> ( bool s )</li> +<li class=fn>bool <a href="#isSelected"><b>isSelected</b></a> () const</li> +<li class=fn>virtual void <a href="#paintCell"><b>paintCell</b></a> ( QPainter * p, const QColorGroup & cg, int column, int width, int align )</li> +<li class=fn>virtual void <a href="#paintBranches"><b>paintBranches</b></a> ( QPainter * p, const QColorGroup & cg, int w, int y, int h )</li> +<li class=fn>virtual void <a href="#paintFocus"><b>paintFocus</b></a> ( QPainter * p, const QColorGroup & cg, const QRect & r )</li> +<li class=fn>QListViewItem * <a href="#firstChild"><b>firstChild</b></a> () const</li> +<li class=fn>QListViewItem * <a href="#nextSibling"><b>nextSibling</b></a> () const</li> +<li class=fn>QListViewItem * <a href="#parent"><b>parent</b></a> () const</li> +<li class=fn>QListViewItem * <a href="#itemAbove"><b>itemAbove</b></a> ()</li> +<li class=fn>QListViewItem * <a href="#itemBelow"><b>itemBelow</b></a> ()</li> +<li class=fn>int <a href="#itemPos"><b>itemPos</b></a> () const</li> +<li class=fn>QListView * <a href="#listView"><b>listView</b></a> () const</li> +<li class=fn>virtual void <a href="#setSelectable"><b>setSelectable</b></a> ( bool enable )</li> +<li class=fn>bool <a href="#isSelectable"><b>isSelectable</b></a> () const</li> +<li class=fn>virtual void <a href="#setExpandable"><b>setExpandable</b></a> ( bool enable )</li> +<li class=fn>bool <a href="#isExpandable"><b>isExpandable</b></a> () const</li> +<li class=fn>void <a href="#repaint"><b>repaint</b></a> () const</li> +<li class=fn>virtual void <a href="#sort"><b>sort</b></a> ()</li> +<li class=fn>void <a href="#moveItem"><b>moveItem</b></a> ( QListViewItem * after )</li> +<li class=fn>virtual void <a href="#setDragEnabled"><b>setDragEnabled</b></a> ( bool allow )</li> +<li class=fn>virtual void <a href="#setDropEnabled"><b>setDropEnabled</b></a> ( bool allow )</li> +<li class=fn>bool <a href="#dragEnabled"><b>dragEnabled</b></a> () const</li> +<li class=fn>bool <a href="#dropEnabled"><b>dropEnabled</b></a> () const</li> +<li class=fn>virtual bool <a href="#acceptDrop"><b>acceptDrop</b></a> ( const QMimeSource * mime ) const</li> +<li class=fn>void <a href="#setVisible"><b>setVisible</b></a> ( bool b )</li> +<li class=fn>bool <a href="#isVisible"><b>isVisible</b></a> () const</li> +<li class=fn>virtual void <a href="#setRenameEnabled"><b>setRenameEnabled</b></a> ( int col, bool b )</li> +<li class=fn>bool <a href="#renameEnabled"><b>renameEnabled</b></a> ( int col ) const</li> +<li class=fn>virtual void <a href="#startRename"><b>startRename</b></a> ( int col )</li> +<li class=fn>virtual void <a href="#setEnabled"><b>setEnabled</b></a> ( bool b )</li> +<li class=fn>bool <a href="#isEnabled"><b>isEnabled</b></a> () const</li> +<li class=fn>virtual int <a href="#rtti"><b>rtti</b></a> () const</li> +<li class=fn>virtual void <a href="#setMultiLinesEnabled"><b>setMultiLinesEnabled</b></a> ( bool b )</li> +<li class=fn>bool <a href="#multiLinesEnabled"><b>multiLinesEnabled</b></a> () const</li> +</ul> +<h2>Protected Members</h2> +<ul> +<li class=fn>virtual void <a href="#enforceSortOrder"><b>enforceSortOrder</b></a> () const</li> +<li class=fn>virtual void <a href="#setHeight"><b>setHeight</b></a> ( int height )</li> +<li class=fn>virtual void <a href="#activate"><b>activate</b></a> ()</li> +<li class=fn>bool <a href="#activatedPos"><b>activatedPos</b></a> ( QPoint & pos )</li> +<li class=fn>virtual void <a href="#dropped"><b>dropped</b></a> ( QDropEvent * e )</li> +<li class=fn>virtual void <a href="#dragEntered"><b>dragEntered</b></a> ()</li> +<li class=fn>virtual void <a href="#dragLeft"><b>dragLeft</b></a> ()</li> +<li class=fn>virtual void <a href="#okRename"><b>okRename</b></a> ( int col )</li> +<li class=fn>virtual void <a href="#cancelRename"><b>cancelRename</b></a> ( int col )</li> +</ul> +<hr><a name="details"></a><h2>Detailed Description</h2> + + +The QListViewItem class implements a list view item. +<p> +<p> A list view item is a multi-column object capable of displaying +itself in a <a href="qlistview.html">QListView</a>. +<p> The easiest way to use QListViewItem is to construct one with a +few constant strings, and either a QListView or another +QListViewItem as parent. +<pre> + (void) new QListViewItem( listView, "Column 1", "Column 2" ); + (void) new QListViewItem( listView->firstChild(), "A", "B", "C" ); + </pre> + +We've discarded the pointers to the items since we can still access +them via their parent <em>listView</em>. By default, QListView sorts its +items; this can be switched off with <a href="qlistview.html#setSorting">QListView::setSorting</a>(-1). +<p> The parent must be another QListViewItem or a QListView. If the +parent is a QListView, the item becomes a top-level item within +that QListView. If the parent is another QListViewItem, the 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 its sub-items. You don't have to keep the pointer 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>() and +<a href="qlistview.html#findItem">QListView::findItem</a>(). +<p> If you call <tt>delete</tt> on a list view item, it will be deleted as +expected, and as usual for <a href="qobject.html">QObject</a>s, if it has any child items +(to any depth), all these will be deleted too. +<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 plain 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 +them are actually visible at the moment). +<p> Here's how to traverse all of an item's children (but not its +children's children, etc.): +Example: +<pre> + QListViewItem * myChild = myItem->firstChild(); + while( myChild ) { + doSomething( myChild ); + myChild = myChild-><a href="#nextSibling">nextSibling</a>(); + } + </pre> + +<p> If you want to iterate over every item, to any level of depth use +an iterator. To iterate over the entire tree, initialize the +iterator with the list view itself; to iterate starting from a +particular item, initialize the iterator with the item: +<p> <pre> + <a href="qlistviewitemiterator.html">QListViewItemIterator</a> it( listview ); + while ( it.<a href="qlistviewitemiterator.html#current">current</a>() ) { + QListViewItem *item = it.<a href="qlistviewitemiterator.html#current">current</a>(); + doSomething( item ); + ++it; + } + </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: +<center><table cellpadding="4" cellspacing="2" border="0"> +<tr bgcolor="#a2c511"> <th valign="top">Function <th valign="top">Description +<tr bgcolor="#f0f0f0"> <td valign="top"><a href="#text">text</a>() +<td valign="top">Returns the text in a column. Many subclasses will compute +this on the fly. +<tr bgcolor="#d0d0d0"> <td valign="top"><a href="#key">key</a>() +<td valign="top">Used for sorting. The default <a href="#key">key</a>() simply calls +<a href="#text">text</a>(), but judicious use of key() can give you fine +control over sorting; for example, <a href="qfiledialog.html">QFileDialog</a> +reimplements key() to sort by date. +<tr bgcolor="#f0f0f0"> <td valign="top"><a href="#setup">setup</a>() +<td valign="top">Called before showing the item and whenever the list +view's font changes, for example. +<tr bgcolor="#d0d0d0"> <td valign="top"><a href="#activate">activate</a>() +<td valign="top">Called whenever the user clicks on the item or presses +Space when the item is the current item. +</table></center> +<p> Some subclasses call <a href="#setExpandable">setExpandable</a>(TRUE) even when they have no +children, and populate themselves when <a href="#setup">setup</a>() or <a href="#setOpen">setOpen</a>(TRUE) is +called. The <a href="dirview-example.html">dirview/dirview.cpp</a> 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 item <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 item <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 top-level list view item in the <a href="qlistview.html">QListView</a> <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 columns' 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 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> +as columns' 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 that has 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 presses the mouse +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> <b>Warning:</b> We recommend that you ignore 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> (e.g. by pressing Esc). +<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. The count only includes +the item's immediate children. + +<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 list view item to <em>i</em> using the column <em>col</em> in <em>ascending</em> order. Returns < 0 if this item is less than <em>i</em>, 0 if +they are equal and > 0 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 can 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>(). + +<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#x1686">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 function is called when a drag enters the item's bounding +rectangle. +<p> The default implementation does nothing, subclasses may need to +reimplement this function. + +<h3 class=fn>void <a name="dragLeft"></a>QListViewItem::dragLeft ()<tt> [virtual protected]</tt> +</h3> +This function is called when a drag leaves the item's bounding +rectangle. +<p> The default implementation does nothing, subclasses may need to +reimplement this function. + +<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 function 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 function. + +<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 only works 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 the first (top) child of this item, or 0 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>() and <a href="#sortChildItems">sortChildItems</a>(). + +<p>Example: <a href="checklists-example.html#x430">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>. +<p> <b>Warning:</b> If you are using <tt>Single</tt> selection mode, then you +should only insert unselected items. + +<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 +not explicitly hidden; otherwise returns FALSE. +<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#x156">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 0 +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> This function might be relatively slow because of the tree +traversions needed to find the correct item. +<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 0 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#x1687">dirview/dirview.cpp</a>. +<h3 class=fn>int <a name="itemPos"></a>QListViewItem::itemPos () const +</h3> +Returns the y coordinate of this 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., it is more efficient to 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. +<p> Note that this function traverses the items to the root to find the +listview. This function will return 0 for taken items - see +<a href="#takeItem">QListViewItem::takeItem</a>() + +<h3 class=fn>void <a name="moveItem"></a>QListViewItem::moveItem ( <a href="qlistviewitem.html">QListViewItem</a> * after ) +</h3> +Move the item to be after item <em>after</em>, which must be one of the +item's siblings. To move an item in the hierarchy, use <a href="#takeItem">takeItem</a>() +and <a href="#insertItem">insertItem</a>(). +<p> Note that this function will have no effect if sorting is enabled +in the list view. + +<h3 class=fn>bool <a name="multiLinesEnabled"></a>QListViewItem::multiLinesEnabled () const +</h3> +Returns TRUE if the item can display multiple lines of text in its +columns; otherwise returns FALSE. + +<h3 class=fn><a href="qlistviewitem.html">QListViewItem</a> * <a name="nextSibling"></a>QListViewItem::nextSibling () const +</h3> + +<p> Returns the sibling item below this item, or 0 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>() and <a href="#sortChildItems">sortChildItems</a>(). + +<p>Example: <a href="tagreader-with-features-example.html#x1965">xml/tagreader-with-features/structureparser.cpp</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 only draw in the rectangle that needs redrawing; <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#x157">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 indicator 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 the parent of this item, or 0 if this item has no parent. +<p> <p>See also <a href="#firstChild">firstChild</a>() and <a href="#nextSibling">nextSibling</a>(). + +<p>Examples: <a href="dirview-example.html#x1688">dirview/dirview.cpp</a> and <a href="qaxcontainer-example-qutlook.html#x2727">qutlook/centralwidget.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 the pixmap for <em>column</em>, or 0 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>Example: <a href="dirview-example.html#x1689">dirview/dirview.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#x593">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>(), so +that you can distinguish between different kinds of list view +items. You should use values greater than 1000 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 list view 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 list view 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 differently (e.g. grayed-out) and are not +accessible 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 each of the item's columns may contain multiple +lines of text; otherwise each of them 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 <b>-</b> 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 <b>+</b> 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#x431">checklists/checklists.cpp</a>, <a href="dirview-example.html#x1690">dirview/dirview.cpp</a>, <a href="dirview-example.html#x1718">dirview/main.cpp</a>, <a href="fileiconview-example.html#x887">fileiconview/mainwindow.cpp</a>, and <a href="tagreader-with-features-example.html#x1966">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#x1691">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 cannot be renamed in-place. + +<h3 class=fn>void <a name="setSelectable"></a>QListViewItem::setSelectable ( bool enable )<tt> [virtual]</tt> +</h3> +Sets this item 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 the mouse. This also applies for the application +programmer (e.g. <a href="#setSelected">setSelected</a>() respects this value). +<p> <p>See also <a href="#isSelectable">isSelectable</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#x594">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#x595">addressbook/centralwidget.cpp</a>, <a href="qaxcontainer-example-qutlook.html#x2728">qutlook/centralwidget.cpp</a>, and <a href="outliner-example.html#x1916">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 +return this item, although you still can reach it by using e.g. +<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#x1692">dirview/dirview.cpp</a>. +<h3 class=fn>void <a name="sort"></a>QListViewItem::sort ()<tt> [virtual]</tt> +</h3> +Sorts all this item's child items using the current 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 this item's children 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 column +<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 +not normally need to call this function because +<a href="#~QListViewItem">QListViewItem::~QListViewItem</a>() calls it. +<p> The normal way to delete an item is to use <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> If a taken item is part of a selection in <tt>Single</tt> selection +mode, it is unselected and selectionChanged() is emitted. If a +taken item is part of a selection in <tt>Multi</tt> or <tt>Extended</tt> +selection mode, it remains selected. +<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 taken 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 href="qstring.html#QString-null">QString::null</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#x596">addressbook/centralwidget.cpp</a>, <a href="dirview-example.html#x1693">dirview/dirview.cpp</a>, <a href="archivesearch-example.html#x477">network/archivesearch/archivedialog.ui.h</a>, and <a href="ftpclient-example.html#x766">network/ftpclient/ftpmainwindow.ui.h</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. +It is more efficient to pass -1 if two or more columns have +changed than to call <a href="#widthChanged">widthChanged</a>() separately for each one. +<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-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 © 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> |