qlistviewitem.html

来自「QT 下载资料仅供参考」· HTML 代码 · 共 738 行 · 第 1/4 页

HTML
738
字号
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/src/widgets/qlistview.cpp:289 --><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&nbsp;Classes</font></a> | <a href="mainclasses.html"><font color="#004faf">Main&nbsp;Classes</font></a> | <a href="annotated.html"><font color="#004faf">Annotated</font></a> | <a href="groups.html"><font color="#004faf">Grouped&nbsp;Classes</font></a> | <a href="functions.html"><font color="#004faf">Functions</font></a></td><td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QListViewItem Class Reference</h1><p>The QListViewItem class implements a list view item.<a href="#details">More...</a><p><tt>#include &lt;<a href="qlistview-h.html">qlistview.h</a>&gt;</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&nbsp;*&nbsp;parent )</div></li><li><div class=fn><a href="#QListViewItem-2"><b>QListViewItem</b></a> ( QListViewItem&nbsp;*&nbsp;parent )</div></li><li><div class=fn><a href="#QListViewItem-3"><b>QListViewItem</b></a> ( QListView&nbsp;*&nbsp;parent, QListViewItem&nbsp;*&nbsp;after )</div></li><li><div class=fn><a href="#QListViewItem-4"><b>QListViewItem</b></a> ( QListViewItem&nbsp;*&nbsp;parent, QListViewItem&nbsp;*&nbsp;after )</div></li><li><div class=fn><a href="#QListViewItem-5"><b>QListViewItem</b></a> ( QListView&nbsp;*&nbsp;parent, QString&nbsp;label1, QString&nbsp;label2 = QString::null, QString&nbsp;label3 = QString::null, QString&nbsp;label4 = QString::null, QString&nbsp;label5 = QString::null, QString&nbsp;label6 = QString::null, QString&nbsp;label7 = QString::null, QString&nbsp;label8 = QString::null )</div></li><li><div class=fn><a href="#QListViewItem-6"><b>QListViewItem</b></a> ( QListViewItem&nbsp;*&nbsp;parent, QString&nbsp;label1, QString&nbsp;label2 = QString::null, QString&nbsp;label3 = QString::null, QString&nbsp;label4 = QString::null, QString&nbsp;label5 = QString::null, QString&nbsp;label6 = QString::null, QString&nbsp;label7 = QString::null, QString&nbsp;label8 = QString::null )</div></li><li><div class=fn><a href="#QListViewItem-7"><b>QListViewItem</b></a> ( QListView&nbsp;*&nbsp;parent, QListViewItem&nbsp;*&nbsp;after, QString&nbsp;label1, QString&nbsp;label2 = QString::null, QString&nbsp;label3 = QString::null, QString&nbsp;label4 = QString::null, QString&nbsp;label5 = QString::null, QString&nbsp;label6 = QString::null, QString&nbsp;label7 = QString::null, QString&nbsp;label8 = QString::null )</div></li><li><div class=fn><a href="#QListViewItem-8"><b>QListViewItem</b></a> ( QListViewItem&nbsp;*&nbsp;parent, QListViewItem&nbsp;*&nbsp;after, QString&nbsp;label1, QString&nbsp;label2 = QString::null, QString&nbsp;label3 = QString::null, QString&nbsp;label4 = QString::null, QString&nbsp;label5 = QString::null, QString&nbsp;label6 = QString::null, QString&nbsp;label7 = QString::null, QString&nbsp;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&nbsp;*&nbsp;newChild )</div></li><li><div class=fn>virtual void <a href="#takeItem"><b>takeItem</b></a> ( QListViewItem&nbsp;*&nbsp;item )</div></li><li><div class=fn>virtual void removeItem ( QListViewItem&nbsp;*&nbsp;item ) &nbsp;<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&nbsp;QFontMetrics&nbsp;&amp;&nbsp;fm, const&nbsp;QListView&nbsp;*&nbsp;lv, int&nbsp;c ) const</div></li><li><div class=fn>void <a href="#widthChanged"><b>widthChanged</b></a> ( int&nbsp;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&nbsp;column, const&nbsp;QString&nbsp;&amp;&nbsp;text )</div></li><li><div class=fn>virtual QString <a href="#text"><b>text</b></a> ( int&nbsp;column ) const</div></li><li><div class=fn>virtual void <a href="#setPixmap"><b>setPixmap</b></a> ( int&nbsp;column, const&nbsp;QPixmap&nbsp;&amp;&nbsp;pm )</div></li><li><div class=fn>virtual const QPixmap * <a href="#pixmap"><b>pixmap</b></a> ( int&nbsp;column ) const</div></li><li><div class=fn>virtual QString <a href="#key"><b>key</b></a> ( int&nbsp;column, bool&nbsp;ascending ) const</div></li><li><div class=fn>virtual int <a href="#compare"><b>compare</b></a> ( QListViewItem&nbsp;*&nbsp;i, int&nbsp;col, bool&nbsp;ascending ) const</div></li><li><div class=fn>virtual void <a href="#sortChildItems"><b>sortChildItems</b></a> ( int&nbsp;column, bool&nbsp;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&nbsp;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&nbsp;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&nbsp;*&nbsp;p, const&nbsp;QColorGroup&nbsp;&amp;&nbsp;cg, int&nbsp;column, int&nbsp;width, int&nbsp;align )</div></li><li><div class=fn>virtual void <a href="#paintBranches"><b>paintBranches</b></a> ( QPainter&nbsp;*&nbsp;p, const&nbsp;QColorGroup&nbsp;&amp;&nbsp;cg, int&nbsp;w, int&nbsp;y, int&nbsp;h )</div></li><li><div class=fn>virtual void <a href="#paintFocus"><b>paintFocus</b></a> ( QPainter&nbsp;*&nbsp;p, const&nbsp;QColorGroup&nbsp;&amp;&nbsp;cg, const&nbsp;QRect&nbsp;&amp;&nbsp;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&nbsp;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&nbsp;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&nbsp;*&nbsp;after )</div></li><li><div class=fn>virtual void <a href="#setDragEnabled"><b>setDragEnabled</b></a> ( bool&nbsp;allow )</div></li><li><div class=fn>virtual void <a href="#setDropEnabled"><b>setDropEnabled</b></a> ( bool&nbsp;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&nbsp;QMimeSource&nbsp;*&nbsp;mime ) const</div></li><li><div class=fn>void <a href="#setVisible"><b>setVisible</b></a> ( bool&nbsp;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&nbsp;col, bool&nbsp;b )</div></li><li><div class=fn>bool <a href="#renameEnabled"><b>renameEnabled</b></a> ( int&nbsp;col ) const</div></li><li><div class=fn>virtual void <a href="#startRename"><b>startRename</b></a> ( int&nbsp;col )</div></li><li><div class=fn>virtual void <a href="#setEnabled"><b>setEnabled</b></a> ( bool&nbsp;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&nbsp;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&nbsp;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&nbsp;&amp;&nbsp;pos )</div></li><li><div class=fn>virtual void <a href="#dropped"><b>dropped</b></a> ( QDropEvent&nbsp;*&nbsp;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&nbsp;col )</div></li><li><div class=fn>virtual void <a href="#cancelRename"><b>cancelRename</b></a> ( int&nbsp;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 displayingitself 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 fewconstant strings.  This creates an item that is a child of <em>parent</em> with two fixed-content strings, and discards the pointer toit:<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 theparent is a QListView, this item is a top-level item within thatQListView.  If the parent is another QListViewItem, this itembecomes 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>(), andtraverse 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 orradio 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 itemsdirectly above and below this item on the screen (even if none ofthe 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-&gt;firstChild();    while( myChild ) {        doSomething( myChild );        myChild = myChild-&gt;<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 sortingorder changes and is undefined if the items are not visible.  Youcan, however, call <a href="#enforceSortOrder">enforceSortOrder</a>() at any time; <a href="qlistview.html">QListView</a> willalways call it before it needs to show an item.<p> Many programs will need to reimplement QListViewItem.  The mostcommonly reimplemented functions are:<ul><li> <a href="#text">text</a>() returns the text in a column.  Many subclasses willcompute that on the fly.<li> <a href="#key">key</a>() is used for sorting.  The default key() simply calls

⌨️ 快捷键说明

复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?