<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- /tmp/qt-4.2.1-harald-1161357942206/qt-x11-opensource-src-4.2.1/src/gui/itemviews/qtreewidget.cpp -->
<head>
<title>Qt 4.2: QTreeWidget Class Reference</title>
<link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><a href="http://www.trolltech.com/products/qt"><img src="images/qt-logo.png" align="left" width="32" height="32" border="0" /></a></td>
<td width="1"> </td><td class="postheader" 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="groups.html"><font color="#004faf">Grouped Classes</font></a> · <a href="modules.html"><font color="#004faf">Modules</font></a> · <a href="functions.html"><font color="#004faf">Functions</font></a></td>
<td align="right" valign="top" width="230"><a href="http://www.trolltech.com"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></a></td></tr></table><h1 align="center">QTreeWidget Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1>
<p>The QTreeWidget class provides a tree view that uses a predefined tree model. <a href="#details">More...</a></p>
<pre> #include <QTreeWidget></pre><p>Inherits <a href="qtreeview.html">QTreeView</a>.</p>
<ul>
<li><a href="qtreewidget-members.html">List of all members, including inherited members</a></li>
<li><a href="qtreewidget-obsolete.html">Obsolete members</a></li>
</ul>
<a name="properties"></a>
<h3>Properties</h3>
<ul>
<li><div class="fn"/><b><a href="qtreewidget.html#columnCount-prop">columnCount</a></b> : int</li>
<li><div class="fn"/><b><a href="qtreewidget.html#topLevelItemCount-prop">topLevelItemCount</a></b> : const int</li>
</ul>
<ul>
<li><div class="fn"/>7 properties inherited from <a href="qtreeview.html#properties">QTreeView</a></li>
<li><div class="fn"/>14 properties inherited from <a href="qabstractitemview.html#properties">QAbstractItemView</a></li>
<li><div class="fn"/>2 properties inherited from <a href="qabstractscrollarea.html#properties">QAbstractScrollArea</a></li>
<li><div class="fn"/>6 properties inherited from <a href="qframe.html#properties">QFrame</a></li>
<li><div class="fn"/>55 properties inherited from <a href="qwidget.html#properties">QWidget</a></li>
<li><div class="fn"/>1 property inherited from <a href="qobject.html#properties">QObject</a></li>
</ul>
<a name="public-functions"></a>
<h3>Public Functions</h3>
<ul>
<li><div class="fn"/><b><a href="qtreewidget.html#QTreeWidget">QTreeWidget</a></b> ( QWidget * <i>parent</i> = 0 )</li>
<li><div class="fn"/><b><a href="qtreewidget.html#dtor.QTreeWidget">~QTreeWidget</a></b> ()</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#addTopLevelItem">addTopLevelItem</a></b> ( QTreeWidgetItem * <i>item</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#addTopLevelItems">addTopLevelItems</a></b> ( const QList<QTreeWidgetItem *> & <i>items</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#closePersistentEditor">closePersistentEditor</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> = 0 )</li>
<li><div class="fn"/>int <b><a href="qtreewidget.html#columnCount-prop">columnCount</a></b> () const</li>
<li><div class="fn"/>int <b><a href="qtreewidget.html#currentColumn">currentColumn</a></b> () const</li>
<li><div class="fn"/>QTreeWidgetItem * <b><a href="qtreewidget.html#currentItem">currentItem</a></b> () const</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#editItem">editItem</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> = 0 )</li>
<li><div class="fn"/>QList<QTreeWidgetItem *> <b><a href="qtreewidget.html#findItems">findItems</a></b> ( const QString & <i>text</i>, Qt::MatchFlags <i>flags</i>, int <i>column</i> = 0 ) const</li>
<li><div class="fn"/>QTreeWidgetItem * <b><a href="qtreewidget.html#headerItem">headerItem</a></b> () const</li>
<li><div class="fn"/>int <b><a href="qtreewidget.html#indexOfTopLevelItem-2">indexOfTopLevelItem</a></b> ( QTreeWidgetItem * <i>item</i> ) const</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#insertTopLevelItem">insertTopLevelItem</a></b> ( int <i>index</i>, QTreeWidgetItem * <i>item</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#insertTopLevelItems">insertTopLevelItems</a></b> ( int <i>index</i>, const QList<QTreeWidgetItem *> & <i>items</i> )</li>
<li><div class="fn"/>QTreeWidgetItem * <b><a href="qtreewidget.html#invisibleRootItem">invisibleRootItem</a></b> () const</li>
<li><div class="fn"/>QTreeWidgetItem * <b><a href="qtreewidget.html#itemAt">itemAt</a></b> ( const QPoint & <i>p</i> ) const</li>
<li><div class="fn"/>QTreeWidgetItem * <b><a href="qtreewidget.html#itemAt-2">itemAt</a></b> ( int <i>x</i>, int <i>y</i> ) const</li>
<li><div class="fn"/>QWidget * <b><a href="qtreewidget.html#itemWidget">itemWidget</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> ) const</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#openPersistentEditor">openPersistentEditor</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> = 0 )</li>
<li><div class="fn"/>QList<QTreeWidgetItem *> <b><a href="qtreewidget.html#selectedItems">selectedItems</a></b> () const</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#columnCount-prop">setColumnCount</a></b> ( int <i>columns</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#setCurrentItem">setCurrentItem</a></b> ( QTreeWidgetItem * <i>item</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#setCurrentItem-2">setCurrentItem</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#setHeaderItem">setHeaderItem</a></b> ( QTreeWidgetItem * <i>item</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#setHeaderLabel">setHeaderLabel</a></b> ( const QString & <i>label</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#setHeaderLabels">setHeaderLabels</a></b> ( const QStringList & <i>labels</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#setItemWidget">setItemWidget</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i>, QWidget * <i>widget</i> )</li>
<li><div class="fn"/>int <b><a href="qtreewidget.html#sortColumn">sortColumn</a></b> () const</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#sortItems">sortItems</a></b> ( int <i>column</i>, Qt::SortOrder <i>order</i> )</li>
<li><div class="fn"/>QTreeWidgetItem * <b><a href="qtreewidget.html#takeTopLevelItem">takeTopLevelItem</a></b> ( int <i>index</i> )</li>
<li><div class="fn"/>QTreeWidgetItem * <b><a href="qtreewidget.html#topLevelItem">topLevelItem</a></b> ( int <i>index</i> ) const</li>
<li><div class="fn"/>int <b><a href="qtreewidget.html#topLevelItemCount-prop">topLevelItemCount</a></b> () const</li>
<li><div class="fn"/>QRect <b><a href="qtreewidget.html#visualItemRect">visualItemRect</a></b> ( const QTreeWidgetItem * <i>item</i> ) const</li>
</ul>
<ul>
<li><div class="fn"/>31 public functions inherited from <a href="qtreeview.html#public-functions">QTreeView</a></li>
<li><div class="fn"/>52 public functions inherited from <a href="qabstractitemview.html#public-functions">QAbstractItemView</a></li>
<li><div class="fn"/>15 public functions inherited from <a href="qabstractscrollarea.html#public-functions">QAbstractScrollArea</a></li>
<li><div class="fn"/>13 public functions inherited from <a href="qframe.html#public-functions">QFrame</a></li>
<li><div class="fn"/>195 public functions inherited from <a href="qwidget.html#public-functions">QWidget</a></li>
<li><div class="fn"/>29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
<li><div class="fn"/>12 public functions inherited from <a href="qpaintdevice.html#public-functions">QPaintDevice</a></li>
</ul>
<a name="public-slots"></a>
<h3>Public Slots</h3>
<ul>
<li><div class="fn"/>void <b><a href="qtreewidget.html#clear">clear</a></b> ()</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#collapseItem">collapseItem</a></b> ( const QTreeWidgetItem * <i>item</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#expandItem">expandItem</a></b> ( const QTreeWidgetItem * <i>item</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#scrollToItem">scrollToItem</a></b> ( const QTreeWidgetItem * <i>item</i>, QAbstractItemView::ScrollHint <i>hint</i> = EnsureVisible )</li>
</ul>
<ul>
<li><div class="fn"/>8 public slots inherited from <a href="qtreeview.html#public-slots">QTreeView</a></li>
<li><div class="fn"/>8 public slots inherited from <a href="qabstractitemview.html#public-slots">QAbstractItemView</a></li>
<li><div class="fn"/>19 public slots inherited from <a href="qwidget.html#public-slots">QWidget</a></li>
<li><div class="fn"/>1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
</ul>
<a name="signals"></a>
<h3>Signals</h3>
<ul>
<li><div class="fn"/>void <b><a href="qtreewidget.html#currentItemChanged">currentItemChanged</a></b> ( QTreeWidgetItem * <i>current</i>, QTreeWidgetItem * <i>previous</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#itemActivated">itemActivated</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#itemChanged">itemChanged</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#itemClicked">itemClicked</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#itemCollapsed">itemCollapsed</a></b> ( QTreeWidgetItem * <i>item</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#itemDoubleClicked">itemDoubleClicked</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#itemEntered">itemEntered</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#itemExpanded">itemExpanded</a></b> ( QTreeWidgetItem * <i>item</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#itemPressed">itemPressed</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> )</li>
<li><div class="fn"/>void <b><a href="qtreewidget.html#itemSelectionChanged">itemSelectionChanged</a></b> ()</li>
</ul>
<ul>
<li><div class="fn"/>2 signals inherited from <a href="qtreeview.html#signals">QTreeView</a></li>
<li><div class="fn"/>6 signals inherited from <a href="qabstractitemview.html#signals">QAbstractItemView</a></li>
<li><div class="fn"/>1 signal inherited from <a href="qwidget.html#signals">QWidget</a></li>
<li><div class="fn"/>1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
</ul>
<a name="protected-functions"></a>
<h3>Protected Functions</h3>
<ul>
<li><div class="fn"/>virtual bool <b><a href="qtreewidget.html#dropMimeData">dropMimeData</a></b> ( QTreeWidgetItem * <i>parent</i>, int <i>index</i>, const QMimeData * <i>data</i>, Qt::DropAction <i>action</i> )</li>
<li><div class="fn"/>QModelIndex <b><a href="qtreewidget.html#indexFromItem">indexFromItem</a></b> ( QTreeWidgetItem * <i>item</i>, int <i>column</i> = 0 ) const</li>
<li><div class="fn"/>QTreeWidgetItem * <b><a href="qtreewidget.html#itemFromIndex">itemFromIndex</a></b> ( const QModelIndex & <i>index</i> ) const</li>
<li><div class="fn"/>QList<QTreeWidgetItem *> <b><a href="qtreewidget.html#items">items</a></b> ( const QMimeData * <i>data</i> ) const</li>
<li><div class="fn"/>virtual QMimeData * <b><a href="qtreewidget.html#mimeData">mimeData</a></b> ( const QList<QTreeWidgetItem *> <i>items</i> ) const</li>
<li><div class="fn"/>virtual QStringList <b><a href="qtreewidget.html#mimeTypes">mimeTypes</a></b> () const</li>
<li><div class="fn"/>virtual Qt::DropActions <b><a href="qtreewidget.html#supportedDropActions">supportedDropActions</a></b> () const</li>
</ul>
<ul>
<li><div class="fn"/>13 protected functions inherited from <a href="qtreeview.html#protected-functions">QTreeView</a></li>
<li><div class="fn"/>33 protected functions inherited from <a href="qabstractitemview.html#protected-functions">QAbstractItemView</a></li>
<li><div class="fn"/>16 protected functions inherited from <a href="qabstractscrollarea.html#protected-functions">QAbstractScrollArea</a></li>
<li><div class="fn"/>38 protected functions inherited from <a href="qwidget.html#protected-functions">QWidget</a></li>
<li><div class="fn"/>7 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
<li><div class="fn"/>1 protected function inherited from <a href="qpaintdevice.html#protected-functions">QPaintDevice</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li><div class="fn"/>4 static public members inherited from <a href="qwidget.html#static-public-members">QWidget</a></li>
<li><div class="fn"/>5 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
<li><div class="fn"/>4 protected slots inherited from <a href="qtreeview.html#protected-slots">QTreeView</a></li>
<li><div class="fn"/>8 protected slots inherited from <a href="qabstractitemview.html#protected-slots">QAbstractItemView</a></li>
<li><div class="fn"/>1 protected slot inherited from <a href="qabstractscrollarea.html#protected-slots">QAbstractScrollArea</a></li>
<li><div class="fn"/>1 protected slot inherited from <a href="qwidget.html#protected-slots">QWidget</a></li>
</ul>
<a name="details"></a>
<hr />
<h2>Detailed Description</h2>
<p>The QTreeWidget class provides a tree view that uses a predefined tree model.</p>
<p>The QTreeWidget class is a convenience class that provides a standard tree widget with a classic item-based interface similar to that used by the <a href="qlistview.html">QListView</a> class in Qt 3. This class is based on Qt's Model/View architecture and uses a default model to hold items, each of which is a <a href="qtreewidgetitem.html">QTreeWidgetItem</a>.</p>
<p>Developers who do not need the flexibility of the Model/View framework can use this class to create simple hierarchical lists very easily. A more flexible approach involves combining a <a href="qtreeview.html">QTreeView</a> with a standard item model. This allows the storage of data to be separated from its representation.</p>
<p>In its simplest form, a tree widget can be constructed in the following way:</p>
<pre> QTreeWidget *treeWidget = new QTreeWidget();
treeWidget->setColumnCount(1);
QList<QTreeWidgetItem *> items;
for (int i = 0; i < 10; ++i)
items.append(new QTreeWidgetItem((QTreeWidget*)0, QStringList(QString("item: %1").arg(i))));
treeWidget->insertTopLevelItems(0, items);</pre>
<p>Before items can be added to the tree widget, the number of columns must be set with <a href="qtreewidget.html#columnCount-prop">setColumnCount</a>(). This allows each item to have one or more labels or other decorations. The number of columns in use can be found with the <a href="qtreewidget.html#columnCount-prop">columnCount</a>() function.</p>
<p>The tree can have a header that contains a section for each column in the widget. It is easiest to set up the labels for each section by supplying a list of strings with <a href="qtreewidget.html#setHeaderLabels">setHeaderLabels</a>(), but a custom header can be constructed with a <a href="qtreewidgetitem.html">QTreeWidgetItem</a> and inserted into the tree with the <a href="qtreewidget.html#setHeaderItem">setHeaderItem</a>() function.</p>
<p>The items in the tree can be sorted by column according to a predefined sort order. If sorting is enabled, the user can sort the items by clicking on a column header. Sorting can be enabled or disabled by calling setSortingEnabled(). The isSortingEnabled() function indicates whether sorting is enabled.</p>
<p><table width="100%" align="center" cellpadding="2" cellspacing="1" border="0">
<tr valign="top" class="odd"><td><img src="images/windowsxp-treeview.png" alt="Screenshot of a Windows XP style tree widget" /></td><td><img src="images/macintosh-treeview.png" alt="Screenshot of a Macintosh style tree widget" /></td><td><img src="images/plastique-treeview.png" alt="Screenshot of a Plastique style tree widget" /></td></tr>
<tr valign="top" class="even"><td>A <a href="gallery-windowsxp.html">Windows XP style</a> tree widget.</td><td>A <a href="gallery-macintosh.html">Macintosh style</a> tree widget.</td><td>A <a href="gallery-plastique.html">Plastique style</a> tree widget.</td></tr>
</table></p>
<p>See also <a href="qtreewidgetitem.html">QTreeWidgetItem</a>, <a href="qtreeview.html">QTreeView</a>, <a href="model-view-programming.html">Model/View Programming</a>, and <a href="tools-settingseditor.html">Settings Editor Example</a>.</p>
<hr />
<h2>Property Documentation</h2>
<h3 class="fn"><a name="columnCount-prop"></a>columnCount : int</h3>
<p>This property holds the number of columns displayed in the tree widget.</p>
<p>Access functions:</p>
<ul>
<li><div class="fn"/><b>int columnCount () const</b></li>
<li><div class="fn"/><b>void setColumnCount ( int <i>columns</i> )</b></li>
</ul>
<h3 class="fn"><a name="topLevelItemCount-prop"></a>topLevelItemCount : const int</h3>
<p>This property holds the number of top-level items.</p>
<p>Access functions:</p>
<ul>
<li><div class="fn"/><b>int topLevelItemCount () const</b></li>
</ul>
<p>See also <a href="qtreewidget.html#columnCount-prop">columnCount</a>() and <a href="qtreewidget.html#currentItem">currentItem</a>().</p>
<hr />
<h2>Member Function Documentation</h2>
<h3 class="fn"><a name="QTreeWidget"></a>QTreeWidget::QTreeWidget ( <a href="qwidget.html">QWidget</a> * <i>parent</i> = 0 )</h3>
<p>Constructs a tree widget with the given <i>parent</i>.</p>
<h3 class="fn"><a name="dtor.QTreeWidget"></a>QTreeWidget::~QTreeWidget ()</h3>
<p>Destroys the tree widget and all its items.</p>
<h3 class="fn"><a name="addTopLevelItem"></a>void QTreeWidget::addTopLevelItem ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i> )</h3>
<p>Appends the <i>item</i> as a top-level item in the widget.</p>
<p>This function was introduced in Qt 4.1.</p>
<p>See also <a href="qtreewidget.html#insertTopLevelItem">insertTopLevelItem</a>().</p>
<h3 class="fn"><a name="addTopLevelItems"></a>void QTreeWidget::addTopLevelItems ( const <a href="qlist.html">QList</a><<a href="qtreewidgetitem.html">QTreeWidgetItem</a> *> & <i>items</i> )</h3>
<p>Appends the list of <i>items</i> as a top-level items in the widget.</p>
<p>See also <a href="qtreewidget.html#insertTopLevelItems">insertTopLevelItems</a>().</p>
<h3 class="fn"><a name="clear"></a>void QTreeWidget::clear () <tt> [slot]</tt></h3>
<p>Clears the tree widget by removing all of its items and selections.</p>
<p><b>Note:</b> Since each item is removed from the tree widget before being deleted, the return value of <a href="qtreewidgetitem.html#treeWidget">QTreeWidgetItem::treeWidget</a>() will be invalid when called from an item's destructor.</p>
<p>See also <a href="qtreewidget.html#takeTopLevelItem">takeTopLevelItem</a>(), <a href="qtreewidget.html#topLevelItemCount-prop">topLevelItemCount</a>(), and <a href="qtreewidget.html#columnCount-prop">columnCount</a>().</p>
<h3 class="fn"><a name="closePersistentEditor"></a>void QTreeWidget::closePersistentEditor ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> = 0 )</h3>
<p>Closes the persistent editor for the <i>item</i> in the given <i>column</i>.</p>
<p>This function has no effect if no persistent editor is open for this combination of item and column.</p>
<p>See also <a href="qtreewidget.html#openPersistentEditor">openPersistentEditor</a>().</p>
<h3 class="fn"><a name="collapseItem"></a>void QTreeWidget::collapseItem ( const <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i> ) <tt> [slot]</tt></h3>
<p>Closes the <i>item</i>. This causes the tree containing the item's children to be collapsed.</p>
<p>See also <a href="qtreewidget.html#expandItem">expandItem</a>(), <a href="qtreewidget.html#currentItem">currentItem</a>(), <a href="qtreewidget.html#itemAt">itemAt</a>(), and <a href="qtreewidget.html#topLevelItem">topLevelItem</a>().</p>
<h3 class="fn"><a name="currentColumn"></a>int QTreeWidget::currentColumn () const</h3>
<p>Returns the current column in the tree widget.</p>
<p>This function was introduced in Qt 4.1.</p>
<p>See also <a href="qtreewidget.html#setCurrentItem">setCurrentItem</a>() and <a href="qtreewidget.html#columnCount-prop">columnCount</a>().</p>
<h3 class="fn"><a name="currentItem"></a><a href="qtreewidgetitem.html">QTreeWidgetItem</a> * QTreeWidget::currentItem () const</h3>
<p>Returns the current item in the tree widget.</p>
<p>See also <a href="qtreewidget.html#setCurrentItem">setCurrentItem</a>() and <a href="qtreewidget.html#currentItemChanged">currentItemChanged</a>().</p>
<h3 class="fn"><a name="currentItemChanged"></a>void QTreeWidget::currentItemChanged ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>current</i>, <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>previous</i> ) <tt> [signal]</tt></h3>
<p>This signal is emitted when the current item changes. The current item is specified by <i>current</i>, and this replaces the <i>previous</i> current item.</p>
<p>See also <a href="qtreewidget.html#setCurrentItem">setCurrentItem</a>().</p>
<h3 class="fn"><a name="dropMimeData"></a>bool QTreeWidget::dropMimeData ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>parent</i>, int <i>index</i>, const <a href="qmimedata.html">QMimeData</a> * <i>data</i>, <a href="qt.html#DropAction-enum">Qt::DropAction</a> <i>action</i> ) <tt> [virtual protected]</tt></h3>
<p>Handles the <i>data</i> supplied by a drag and drop operation that ended with the given <i>action</i> in the <i>index</i> in the given <i>parent</i> item.</p>
<p>The default implementation returns true if the drop was successfully handled by decoding the mime data and inserting it into the model; otherwise it returns false.</p>
<p>See also <a href="qtreewidget.html#supportedDropActions">supportedDropActions</a>().</p>
<h3 class="fn"><a name="editItem"></a>void QTreeWidget::editItem ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> = 0 )</h3>
<p>Starts editing the <i>item</i> in the given <i>column</i> if it is editable.</p>
<h3 class="fn"><a name="expandItem"></a>void QTreeWidget::expandItem ( const <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i> ) <tt> [slot]</tt></h3>
<p>Expands the <i>item</i>. This causes the tree containing the item's children to be expanded.</p>
<p>See also <a href="qtreewidget.html#collapseItem">collapseItem</a>(), <a href="qtreewidget.html#currentItem">currentItem</a>(), <a href="qtreewidget.html#itemAt">itemAt</a>(), <a href="qtreewidget.html#topLevelItem">topLevelItem</a>(), and <a href="qtreewidget.html#itemExpanded">itemExpanded</a>().</p>
<h3 class="fn"><a name="findItems"></a><a href="qlist.html">QList</a><<a href="qtreewidgetitem.html">QTreeWidgetItem</a> *> QTreeWidget::findItems ( const <a href="qstring.html">QString</a> & <i>text</i>, <a href="qt.html#MatchFlag-enum">Qt::MatchFlags</a> <i>flags</i>, int <i>column</i> = 0 ) const</h3>
<p>Returns a list of items that match the given <i>text</i>, using the given <i>flags</i>, in the given <i>column</i>.</p>
<h3 class="fn"><a name="headerItem"></a><a href="qtreewidgetitem.html">QTreeWidgetItem</a> * QTreeWidget::headerItem () const</h3>
<p>Returns the item used for the tree widget's header.</p>
<p>See also <a href="qtreewidget.html#setHeaderItem">setHeaderItem</a>().</p>
<h3 class="fn"><a name="indexFromItem"></a><a href="qmodelindex.html">QModelIndex</a> QTreeWidget::indexFromItem ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> = 0 ) const <tt> [protected]</tt></h3>
<p>Returns the <a href="qmodelindex.html">QModelIndex</a> assocated with the given <i>item</i> in the given <i>column</i>.</p>
<p>See also <a href="qtreewidget.html#itemFromIndex">itemFromIndex</a>() and <a href="qtreewidget.html#topLevelItem">topLevelItem</a>().</p>
<h3 class="fn"><a name="indexOfTopLevelItem-2"></a>int QTreeWidget::indexOfTopLevelItem ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i> ) const</h3>
<p>This is an overloaded member function, provided for convenience.</p>
<p>Returns the index of the given top-level <i>item</i>, or -1 if the item cannot be found.</p>
<p>See also <a href="qtreewidget.html#sortItems">sortItems</a>() and <a href="qtreewidget.html#topLevelItemCount-prop">topLevelItemCount</a>().</p>
<h3 class="fn"><a name="insertTopLevelItem"></a>void QTreeWidget::insertTopLevelItem ( int <i>index</i>, <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i> )</h3>
<p>Inserts the <i>item</i> at <i>index</i> in the top level in the view.</p>
<p>If the item has already been inserted somewhere else it wont be inserted.</p>
<p>See also <a href="qtreewidget.html#addTopLevelItem">addTopLevelItem</a>() and <a href="qtreewidget.html#columnCount-prop">columnCount</a>().</p>
<h3 class="fn"><a name="insertTopLevelItems"></a>void QTreeWidget::insertTopLevelItems ( int <i>index</i>, const <a href="qlist.html">QList</a><<a href="qtreewidgetitem.html">QTreeWidgetItem</a> *> & <i>items</i> )</h3>
<p>Inserts the list of <i>items</i> at <i>index</i> in the top level in the view.</p>
<p>Items that have already been inserted somewhere else wont be inserted.</p>
<p>This function was introduced in Qt 4.1.</p>
<p>See also <a href="qtreewidget.html#addTopLevelItems">addTopLevelItems</a>().</p>
<h3 class="fn"><a name="invisibleRootItem"></a><a href="qtreewidgetitem.html">QTreeWidgetItem</a> * QTreeWidget::invisibleRootItem () const</h3>
<p>Returns the tree widget's invisible root item.</p>
<p>The invisible root item provides access to the tree widget's top-level items through the <a href="qtreewidgetitem.html">QTreeWidgetItem</a> API, making it possible to write functions that can treat top-level items and their children in a uniform way; for example, recursive functions.</p>
<p>This function was introduced in Qt 4.2.</p>
<h3 class="fn"><a name="itemActivated"></a>void QTreeWidget::itemActivated ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> ) <tt> [signal]</tt></h3>
<p>This signal is emitted when the user activates an item by single- or double-clicking (depending on the platform, i.e. on the <a href="qstyle.html#StyleHint-enum">QStyle::SH_ItemView_ActivateItemOnSingleClick</a> style hint) or pressing a special key (e.g., <b>Enter</b>).</p>
<p>The specified <i>item</i> is the item that was clicked, or 0 if no item was clicked. The <i>column</i> is the item's column that was clicked, or -1 if no item was clicked.</p>
<h3 class="fn"><a name="itemAt"></a><a href="qtreewidgetitem.html">QTreeWidgetItem</a> * QTreeWidget::itemAt ( const <a href="qpoint.html">QPoint</a> & <i>p</i> ) const</h3>
<p>Returns a pointer to the item at the coordinates <i>p</i>.</p>
<p>See also <a href="qtreewidget.html#visualItemRect">visualItemRect</a>().</p>
<h3 class="fn"><a name="itemAt-2"></a><a href="qtreewidgetitem.html">QTreeWidgetItem</a> * QTreeWidget::itemAt ( int <i>x</i>, int <i>y</i> ) const</h3>
<p>This is an overloaded member function, provided for convenience.</p>
<p>Returns a pointer to the item at the coordinates (<i>x</i>, <i>y</i>).</p>
<h3 class="fn"><a name="itemChanged"></a>void QTreeWidget::itemChanged ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> ) <tt> [signal]</tt></h3>
<p>This signal is emitted when the contents of the <i>column</i> in the specified <i>item</i> changes.</p>
<h3 class="fn"><a name="itemClicked"></a>void QTreeWidget::itemClicked ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> ) <tt> [signal]</tt></h3>
<p>This signal is emitted when the user clicks inside the widget.</p>
<p>The specified <i>item</i> is the item that was clicked, or 0 if no item was clicked. The <i>column</i> is the item's column that was clicked, or -1 if no item was clicked.</p>
<h3 class="fn"><a name="itemCollapsed"></a>void QTreeWidget::itemCollapsed ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i> ) <tt> [signal]</tt></h3>
<p>This signal is emitted when the specified <i>item</i> is collapsed so that none of its children are displayed.</p>
<p>See also <a href="qtreewidget-obsolete.html#isItemExpanded">isItemExpanded</a>().</p>
<h3 class="fn"><a name="itemDoubleClicked"></a>void QTreeWidget::itemDoubleClicked ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> ) <tt> [signal]</tt></h3>
<p>This signal is emitted when the user double clicks inside the widget.</p>
<p>The specified <i>item</i> is the item that was clicked, or 0 if no item was clicked. The <i>column</i> is the item's column that was clicked, or -1 if no item was clicked.</p>
<h3 class="fn"><a name="itemEntered"></a>void QTreeWidget::itemEntered ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> ) <tt> [signal]</tt></h3>
<p>This signal is emitted when the mouse cursor enters an <i>item</i> over the specified <i>column</i>. <a href="qtreewidget.html">QTreeWidget</a> mouse tracking needs to be enabled for this feature to work.</p>
<h3 class="fn"><a name="itemExpanded"></a>void QTreeWidget::itemExpanded ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i> ) <tt> [signal]</tt></h3>
<p>This signal is emitted when the specified <i>item</i> is expanded so that all of its children are displayed.</p>
<p>See also <a href="qtreewidget-obsolete.html#setItemExpanded">setItemExpanded</a>() and <a href="qtreewidget-obsolete.html#isItemExpanded">isItemExpanded</a>().</p>
<h3 class="fn"><a name="itemFromIndex"></a><a href="qtreewidgetitem.html">QTreeWidgetItem</a> * QTreeWidget::itemFromIndex ( const <a href="qmodelindex.html">QModelIndex</a> & <i>index</i> ) const <tt> [protected]</tt></h3>
<p>Returns a pointer to the <a href="qtreewidgetitem.html">QTreeWidgetItem</a> assocated with the given <i>index</i>.</p>
<p>See also <a href="qtreewidget.html#indexFromItem">indexFromItem</a>().</p>
<h3 class="fn"><a name="itemPressed"></a>void QTreeWidget::itemPressed ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> ) <tt> [signal]</tt></h3>
<p>This signal is emitted when the user presses a mouse button inside the widget.</p>
<p>The specified <i>item</i> is the item that was clicked, or 0 if no item was clicked. The <i>column</i> is the item's column that was clicked, or -1 if no item was clicked.</p>
<h3 class="fn"><a name="itemSelectionChanged"></a>void QTreeWidget::itemSelectionChanged () <tt> [signal]</tt></h3>
<p>This signal is emitted when the selection changes in the tree widget. The current selection can be found with <a href="qtreewidget.html#selectedItems">selectedItems</a>().</p>
<h3 class="fn"><a name="itemWidget"></a><a href="qwidget.html">QWidget</a> * QTreeWidget::itemWidget ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> ) const</h3>
<p>Returns the widget displayed in the cell specified by <i>item</i> and the given <i>column</i>.</p>
<p>This function was introduced in Qt 4.1.</p>
<p>See also <a href="qtreewidget.html#setItemWidget">setItemWidget</a>().</p>
<h3 class="fn"><a name="items"></a><a href="qlist.html">QList</a><<a href="qtreewidgetitem.html">QTreeWidgetItem</a> *> QTreeWidget::items ( const <a href="qmimedata.html">QMimeData</a> * <i>data</i> ) const <tt> [protected]</tt></h3>
<p>Returns a list of pointers to the items contained in the <i>data</i> object. If the object was not created by a <a href="qtreewidget.html">QTreeWidget</a> in the same process, the list is empty.</p>
<h3 class="fn"><a name="mimeData"></a><a href="qmimedata.html">QMimeData</a> * QTreeWidget::mimeData ( const <a href="qlist.html">QList</a><<a href="qtreewidgetitem.html">QTreeWidgetItem</a> *> <i>items</i> ) const <tt> [virtual protected]</tt></h3>
<p>Returns an object that contains a serialized description of the specified <i>items</i>. The format used to describe the items is obtained from the <a href="qtreewidget.html#mimeTypes">mimeTypes</a>() function.</p>
<p>If the list of items is empty, 0 is returned rather than a serialized empty list.</p>
<h3 class="fn"><a name="mimeTypes"></a><a href="qstringlist.html">QStringList</a> QTreeWidget::mimeTypes () const <tt> [virtual protected]</tt></h3>
<p>Returns a list of MIME types that can be used to describe a list of treewidget items.</p>
<p>See also <a href="qtreewidget.html#mimeData">mimeData</a>().</p>
<h3 class="fn"><a name="openPersistentEditor"></a>void QTreeWidget::openPersistentEditor ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> = 0 )</h3>
<p>Opens a persistent editor for the <i>item</i> in the given <i>column</i>.</p>
<p>See also <a href="qtreewidget.html#closePersistentEditor">closePersistentEditor</a>().</p>
<h3 class="fn"><a name="scrollToItem"></a>void QTreeWidget::scrollToItem ( const <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, <a href="qabstractitemview.html#ScrollHint-enum">QAbstractItemView::ScrollHint</a> <i>hint</i> = EnsureVisible ) <tt> [slot]</tt></h3>
<p>Ensures that the <i>item</i> is visible, scrolling the view if necessary using the specified <i>hint</i>.</p>
<p>See also <a href="qtreewidget.html#currentItem">currentItem</a>(), <a href="qtreewidget.html#itemAt">itemAt</a>(), and <a href="qtreewidget.html#topLevelItem">topLevelItem</a>().</p>
<h3 class="fn"><a name="selectedItems"></a><a href="qlist.html">QList</a><<a href="qtreewidgetitem.html">QTreeWidgetItem</a> *> QTreeWidget::selectedItems () const</h3>
<p>Returns a list of all selected non-hidden items.</p>
<p>See also <a href="qtreewidget.html#itemSelectionChanged">itemSelectionChanged</a>().</p>
<h3 class="fn"><a name="setCurrentItem"></a>void QTreeWidget::setCurrentItem ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i> )</h3>
<p>Sets the current <i>item</i> in the tree widget.</p>
<p>Depending on the current selection mode, the item may also be selected.</p>
<p>See also <a href="qtreewidget.html#currentItem">currentItem</a>() and <a href="qtreewidget.html#currentItemChanged">currentItemChanged</a>().</p>
<h3 class="fn"><a name="setCurrentItem-2"></a>void QTreeWidget::setCurrentItem ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i> )</h3>
<p>This is an overloaded member function, provided for convenience.</p>
<p>Sets the current <i>item</i> in the tree widget and the curernt column to <i>column</i>.</p>
<p>This function was introduced in Qt 4.1.</p>
<p>See also <a href="qtreewidget.html#currentItem">currentItem</a>().</p>
<h3 class="fn"><a name="setHeaderItem"></a>void QTreeWidget::setHeaderItem ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i> )</h3>
<p>Sets the header <i>item</i> for the tree widget. The label for each column in the header is supplied by the corresponding label in the item.</p>
<p>The tree widget takes ownership of the item.</p>
<p>See also <a href="qtreewidget.html#headerItem">headerItem</a>() and <a href="qtreewidget.html#setHeaderLabels">setHeaderLabels</a>().</p>
<h3 class="fn"><a name="setHeaderLabel"></a>void QTreeWidget::setHeaderLabel ( const <a href="qstring.html">QString</a> & <i>label</i> )</h3>
<p>Same as setHeaderLabels(<a href="qstringlist.html">QStringList</a>(<i>label</i>)).</p>
<p>This function was introduced in Qt 4.2.</p>
<h3 class="fn"><a name="setHeaderLabels"></a>void QTreeWidget::setHeaderLabels ( const <a href="qstringlist.html">QStringList</a> & <i>labels</i> )</h3>
<p>Adds a column in the header for each item in the <i>labels</i> list, and sets the label for each column.</p>
<p>Note that setHeaderLabels() won't remove existing columns.</p>
<p>See also <a href="qtreewidget.html#setHeaderItem">setHeaderItem</a>() and <a href="qtreewidget.html#setHeaderLabel">setHeaderLabel</a>().</p>
<h3 class="fn"><a name="setItemWidget"></a>void QTreeWidget::setItemWidget ( <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i>, int <i>column</i>, <a href="qwidget.html">QWidget</a> * <i>widget</i> )</h3>
<p>Sets the given <i>widget</i> to be displayed in the cell specified by the given <i>item</i> and <i>column</i>.</p>
<p>Note that the given <i>widget</i>'s <a href="qwidget.html">autoFillBackground</a> property must be set to true, otherwise the widget's background will be transparent, showing both the model data and the tree widget item.</p>
<p>This function should only be used to display static content in the place of a tree widget item. If you want to display custom dynamic content or implement a custom editor widget, use <a href="qtreeview.html">QTreeView</a> and subclass <a href="qitemdelegate.html">QItemDelegate</a> instead.</p>
<p>This function was introduced in Qt 4.1.</p>
<p>See also <a href="qtreewidget.html#itemWidget">itemWidget</a>() and <a href="model-view-delegate.html">Delegate Classes</a>.</p>
<h3 class="fn"><a name="sortColumn"></a>int QTreeWidget::sortColumn () const</h3>
<p>Returns the column used to sort the contents of the widget.</p>
<p>This function was introduced in Qt 4.1.</p>
<p>See also <a href="qtreewidget.html#sortItems">sortItems</a>().</p>
<h3 class="fn"><a name="sortItems"></a>void QTreeWidget::sortItems ( int <i>column</i>, <a href="qt.html#SortOrder-enum">Qt::SortOrder</a> <i>order</i> )</h3>
<p>Sorts the items in the widget in the specified <i>order</i> by the values in the given <i>column</i>.</p>
<p>See also <a href="qtreewidget.html#sortColumn">sortColumn</a>().</p>
<h3 class="fn"><a name="supportedDropActions"></a><a href="qt.html#DropAction-enum">Qt::DropActions</a> QTreeWidget::supportedDropActions () const <tt> [virtual protected]</tt></h3>
<p>Returns the drop actions supported by this view.</p>
<p>See also <a href="qt.html#DropAction-enum">Qt::DropActions</a>.</p>
<h3 class="fn"><a name="takeTopLevelItem"></a><a href="qtreewidgetitem.html">QTreeWidgetItem</a> * QTreeWidget::takeTopLevelItem ( int <i>index</i> )</h3>
<p>Removes the top-level item at the given <i>index</i> in the tree and returns it, otherwise returns 0;</p>
<p>See also <a href="qtreewidget.html#insertTopLevelItem">insertTopLevelItem</a>(), <a href="qtreewidget.html#topLevelItem">topLevelItem</a>(), and <a href="qtreewidget.html#topLevelItemCount-prop">topLevelItemCount</a>().</p>
<h3 class="fn"><a name="topLevelItem"></a><a href="qtreewidgetitem.html">QTreeWidgetItem</a> * QTreeWidget::topLevelItem ( int <i>index</i> ) const</h3>
<p>Returns the top level item at the given <i>index</i>, or 0 if the item does not exist.</p>
<p>See also <a href="qtreewidget.html#topLevelItemCount-prop">topLevelItemCount</a>() and <a href="qtreewidget.html#insertTopLevelItem">insertTopLevelItem</a>().</p>
<h3 class="fn"><a name="visualItemRect"></a><a href="qrect.html">QRect</a> QTreeWidget::visualItemRect ( const <a href="qtreewidgetitem.html">QTreeWidgetItem</a> * <i>item</i> ) const</h3>
<p>Returns the rectangle on the viewport occupied by the item at <i>item</i>.</p>
<p>See also <a href="qtreewidget.html#itemAt">itemAt</a>().</p>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td width="30%">Copyright © 2006 <a href="trolltech.html">Trolltech</a></td>
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
<td width="30%" align="right"><div align="right">Qt 4.2.1</div></td>
</tr></table></div></address></body>
</html>
