# QTreeWidget Class Reference ## [[QtGui](index.htm) module] 該QTreeWidget類提供了使用預定義樹模型的樹視圖。[More...](#details) 繼承[QTreeView](qtreeview.html)。 ### Methods * `__init__ (self, QWidget?parent?=?None)` * `addTopLevelItem (self, QTreeWidgetItem?item)` * `addTopLevelItems (self, list-of-QTreeWidgetItem?items)` * `clear (self)` * `closePersistentEditor (self, QTreeWidgetItem?item, int?column?=?0)` * `collapseItem (self, QTreeWidgetItem?item)` * `int columnCount (self)` * `int currentColumn (self)` * `QTreeWidgetItem currentItem (self)` * `dropEvent (self, QDropEvent?event)` * `bool dropMimeData (self, QTreeWidgetItem?parent, int?index, QMimeData?data, Qt.DropAction?action)` * `editItem (self, QTreeWidgetItem?item, int?column?=?0)` * `bool event (self, QEvent?e)` * `expandItem (self, QTreeWidgetItem?item)` * `list-of-QTreeWidgetItem findItems (self, QString?text, Qt.MatchFlags?flags, int?column?=?0)` * `QTreeWidgetItem headerItem (self)` * `QModelIndex indexFromItem (self, QTreeWidgetItem?item, int?column?=?0)` * `int indexOfTopLevelItem (self, QTreeWidgetItem?item)` * `insertTopLevelItem (self, int?index, QTreeWidgetItem?item)` * `insertTopLevelItems (self, int?index, list-of-QTreeWidgetItem?items)` * `QTreeWidgetItem invisibleRootItem (self)` * `bool isFirstItemColumnSpanned (self, QTreeWidgetItem?item)` * `bool isItemExpanded (self, QTreeWidgetItem?item)` * `bool isItemHidden (self, QTreeWidgetItem?item)` * `bool isItemSelected (self, QTreeWidgetItem?item)` * `bool isSortingEnabled (self)` * `QTreeWidgetItem itemAbove (self, QTreeWidgetItem?item)` * `QTreeWidgetItem itemAt (self, QPoint?p)` * `QTreeWidgetItem itemAt (self, int?ax, int?ay)` * `QTreeWidgetItem itemBelow (self, QTreeWidgetItem?item)` * `QTreeWidgetItem itemFromIndex (self, QModelIndex?index)` * `list-of-QTreeWidgetItem items (self, QMimeData?data)` * `QWidget itemWidget (self, QTreeWidgetItem?item, int?column)` * `QMimeData mimeData (self, list-of-QTreeWidgetItem?items)` * `QStringList mimeTypes (self)` * `openPersistentEditor (self, QTreeWidgetItem?item, int?column?=?0)` * `removeItemWidget (self, QTreeWidgetItem?item, int?column)` * `scrollToItem (self, QTreeWidgetItem?item, QAbstractItemView.ScrollHint?hint?=?QAbstractItemView.EnsureVisible)` * `list-of-QTreeWidgetItem selectedItems (self)` * `setColumnCount (self, int?columns)` * `setCurrentItem (self, QTreeWidgetItem?item)` * `setCurrentItem (self, QTreeWidgetItem?item, int?column)` * `setCurrentItem (self, QTreeWidgetItem?item, int?column, QItemSelectionModel.SelectionFlags?command)` * `setFirstItemColumnSpanned (self, QTreeWidgetItem?item, bool?span)` * `setHeaderItem (self, QTreeWidgetItem?item)` * `setHeaderLabel (self, QString?alabel)` * `setHeaderLabels (self, QStringList?labels)` * `setItemExpanded (self, QTreeWidgetItem?item, bool?expand)` * `setItemHidden (self, QTreeWidgetItem?item, bool?hide)` * `setItemSelected (self, QTreeWidgetItem?item, bool?select)` * `setItemWidget (self, QTreeWidgetItem?item, int?column, QWidget?widget)` * `setSelectionModel (self, QItemSelectionModel?selectionModel)` * `setSortingEnabled (self, bool?enable)` * `int sortColumn (self)` * `sortItems (self, int?column, Qt.SortOrder?order)` * `Qt.DropActions supportedDropActions (self)` * `QTreeWidgetItem takeTopLevelItem (self, int?index)` * `QTreeWidgetItem topLevelItem (self, int?index)` * `int topLevelItemCount (self)` * `QRect visualItemRect (self, QTreeWidgetItem?item)` ### Qt Signals * `void currentItemChanged (QTreeWidgetItem *,QTreeWidgetItem *)` * `void itemActivated (QTreeWidgetItem *,int)` * `void itemChanged (QTreeWidgetItem *,int)` * `void itemClicked (QTreeWidgetItem *,int)` * `void itemCollapsed (QTreeWidgetItem *)` * `void itemDoubleClicked (QTreeWidgetItem *,int)` * `void itemEntered (QTreeWidgetItem *,int)` * `void itemExpanded (QTreeWidgetItem *)` * `void itemPressed (QTreeWidgetItem *,int)` * `void itemSelectionChanged ()` * * * ## Detailed Description 該QTreeWidget類提供了使用預定義樹模型的樹視圖。 該QTreeWidget類是一個方便的類，它提供了一個標準的樹部件采用了經典的基于項目的界面相似，所使用的[QListView](qlistview.html)類的Qt 3 。每一個這個類是基于Qt的模型/視圖結構，并使用默認的模型來保存項目，是一個[QTreeWidgetItem](qtreewidgetitem.html)。 開發商誰也不需要的模型/視圖框架的靈活性，可以使用這個類來很容易地創建簡單的層次結構列表。更靈活的方法涉及一個組合[QTreeView](qtreeview.html)與標準的項目模型。這使得數據的存儲也可以從它的表示分離。 在其最簡單的形式，樹控件可以通過以下方式構造： ``` QTreeWidget *treeWidget = new QTreeWidget(); treeWidget->setColumnCount(1); [QList](index.htm)<[QTreeWidgetItem](qtreewidgetitem.html) *> items; for (int i = 0; i < 10; ++i) items.append(new [QTreeWidgetItem](qtreewidgetitem.html)((QTreeWidget*)0, [QStringList](qstringlist.html)([QString](qstring.html)("item: %1").arg(i)))); treeWidget->insertTopLevelItems(0, items); ``` 前項可被添加到樹部件，列的數目必須與設置[setColumnCount](qtreewidget.html#columnCount-prop)（ ） 。這允許每個產品有一個或多個標籤或其它裝飾。在使用列數可以與被發現[columnCount](qtreewidget.html#columnCount-prop)（）函數。 樹可以有一個包含部分在widget每列的標題。這是最簡單的通過提供一個字符串列表來設置每個部分的標籤[setHeaderLabels](qtreewidget.html#setHeaderLabels)（ ） ，但自定義標題可以與構造[QTreeWidgetItem](qtreewidgetitem.html)和插入到與樹[setHeaderItem](qtreewidget.html#setHeaderItem)（）函數。 在樹中的項目可以按列根據預定義的排序順序進行排序。如果排序時啟用，用戶可以通過單擊列標題中的項目進行排序。排序可以啟用或禁用通過調用[setSortingEnabled()](qtreeview.html#sortingEnabled-prop)。該[isSortingEnabled()](qtreeview.html#sortingEnabled-prop)功能指示排序是否已啟用。 |  |  |  | | A [Windows XP style](index.htm) tree widget. | A [Macintosh style](index.htm) tree widget. | A [Plastique style](index.htm) tree widget. | * * * ## Method Documentation ``` QTreeWidget.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個樹形控件與給定_parent_。 ``` QTreeWidget.addTopLevelItem (self, QTreeWidgetItem?item) ``` 該_item_說法有它的所有權轉移給Qt的。 追加_item_如在小部件的頂級項目。 這個函數是Qt 4.1中引入。 **See also** [insertTopLevelItem](qtreewidget.html#insertTopLevelItem)（ ） 。 ``` QTreeWidget.addTopLevelItems (self, list-of-QTreeWidgetItem?items) ``` 該_items_說法有它的所有權轉移給Qt的。 附加列表_items_如在小部件的頂級項目。 **See also** [insertTopLevelItems](qtreewidget.html#insertTopLevelItems)（ ） 。 ``` QTreeWidget.clear (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void clear()`。 通過刪除所有的項目，并選擇清除樹部件。 **Note:**由于每個項目被刪除之前從樹控件中刪除，返回值[QTreeWidgetItem.treeWidget](qtreewidgetitem.html#treeWidget)（ ）將是無效的從一個項目的析構函數被調用時。 **See also** [takeTopLevelItem](qtreewidget.html#takeTopLevelItem)（ ）[topLevelItemCount](qtreewidget.html#topLevelItemCount-prop)（）和[columnCount](qtreewidget.html#columnCount-prop)（ ） 。 ``` QTreeWidget.closePersistentEditor (self, QTreeWidgetItem?item, int?column?=?0) ``` 關閉持久編輯的_item_在給定的_column_。 這個功能有沒有影響，如果沒有持續的編輯器打開的項目和柱的結合。 **See also** [openPersistentEditor](qtreewidget.html#openPersistentEditor)（ ） 。 ``` QTreeWidget.collapseItem (self, QTreeWidgetItem?item) ``` 這種方法也是一個Qt槽與C + +的簽名`void collapseItem(const QTreeWidgetItem *)`。 關閉_item_。這會導致崩潰了包含該項目的子項的樹。 **See also** [expandItem](qtreewidget.html#expandItem)（ ）[currentItem](qtreewidget.html#currentItem)（ ）[itemAt](qtreewidget.html#itemAt)（）和[topLevelItem](qtreewidget.html#topLevelItem)（ ） 。 ``` int QTreeWidget.columnCount (self) ``` ``` int QTreeWidget.currentColumn (self) ``` 返回在樹插件的當前列。 這個函數是Qt 4.1中引入。 **See also** [setCurrentItem](qtreewidget.html#setCurrentItem)（）和[columnCount](qtreewidget.html#columnCount-prop)（ ） 。 ``` QTreeWidgetItem QTreeWidget.currentItem (self) ``` [ 返回在樹插件的當前項。 ](qtreewidgetitem.html) [**See also**](qtreewidgetitem.html) [setCurrentItem](qtreewidget.html#setCurrentItem)（）和[currentItemChanged](qtreewidget.html#currentItemChanged)（ ） 。 ``` QTreeWidget.dropEvent (self, QDropEvent?event) ``` 從重新實現[QWidget.dropEvent](qwidget.html#dropEvent)（ ） 。 ``` bool QTreeWidget.dropMimeData (self, QTreeWidgetItem?parent, int?index, QMimeData?data, Qt.DropAction?action) ``` 處理_data_通過拖放操作，與給定的供給結束_action_在_index_在給定的_parent_項目。 默認實現返回True，如果下跌是由解碼MIME數據并將其插入到模型成功地處理，否則返回False 。 **See also** [supportedDropActions](qtreewidget.html#supportedDropActions)（ ） 。 ``` QTreeWidget.editItem (self, QTreeWidgetItem?item, int?column?=?0) ``` 開始編輯_item_在給定的_column_如果是可編輯的。 ``` bool QTreeWidget.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（ ） 。 ``` QTreeWidget.expandItem (self, QTreeWidgetItem?item) ``` 這種方法也是一個Qt槽與C + +的簽名`void expandItem(const QTreeWidgetItem *)`。 擴展_item_。這會導致擴大了包含該項目的子項的樹。 **See also** [collapseItem](qtreewidget.html#collapseItem)（ ）[currentItem](qtreewidget.html#currentItem)（ ）[itemAt](qtreewidget.html#itemAt)（ ）[topLevelItem](qtreewidget.html#topLevelItem)（）和[itemExpanded](qtreewidget.html#itemExpanded)（ ） 。 ``` list-of-QTreeWidgetItem QTreeWidget.findItems (self, QString?text, Qt.MatchFlags?flags, int?column?=?0) ``` 返回匹配給定的項目清單_text_，使用給定的_flags_在給定的_column_。 ``` QTreeWidgetItem QTreeWidget.headerItem (self) ``` [ 返回用于樹部件的頭的項目。 ](qtreewidgetitem.html) [**See also**](qtreewidgetitem.html) [setHeaderItem](qtreewidget.html#setHeaderItem)（ ） 。 ``` QModelIndex QTreeWidget.indexFromItem (self, QTreeWidgetItem?item, int?column?=?0) ``` [](qmodelindex.html) [返回](qmodelindex.html)[QModelIndex](qmodelindex.html)assocated用給定的_item_在給定的_column_。 **See also** [itemFromIndex](qtreewidget.html#itemFromIndex)（）和[topLevelItem](qtreewidget.html#topLevelItem)（ ） 。 ``` int QTreeWidget.indexOfTopLevelItem (self, QTreeWidgetItem?item) ``` 返回給定的頂層的索引_item_，或-1，如果項目無法找到。 **See also** [sortItems](qtreewidget.html#sortItems)（）和[topLevelItemCount](qtreewidget.html#topLevelItemCount-prop)（ ） 。 ``` QTreeWidget.insertTopLevelItem (self, int?index, QTreeWidgetItem?item) ``` 該_item_說法有它的所有權轉移給Qt的。 插入_item_在_index_在視圖中的頂級水準。 如果該項目已被插入別的地方它不會被插入。 **See also** [addTopLevelItem](qtreewidget.html#addTopLevelItem)（）和[columnCount](qtreewidget.html#columnCount-prop)（ ） 。 ``` QTreeWidget.insertTopLevelItems (self, int?index, list-of-QTreeWidgetItem?items) ``` 該_items_說法有它的所有權轉移給Qt的。 插入列表_items_在_index_在視圖中的頂級水準。 那些已經被插入其他地方的項目不會被插入。 這個函數是Qt 4.1中引入。 **See also** [addTopLevelItems](qtreewidget.html#addTopLevelItems)（ ） 。 ``` QTreeWidgetItem QTreeWidget.invisibleRootItem (self) ``` [ 返回樹部件的無形之根項目。 ](qtreewidgetitem.html) [看不見的根項目，通過提供對樹控件的頂級項目](qtreewidgetitem.html)[QTreeWidgetItem](qtreewidgetitem.html)的API ，從而可以寫，可以治療頂級項目和他們的孩子在一個統一的方式的功能，例如，遞歸函數。 這個函數中引入了Qt 4.2中。 ``` bool QTreeWidget.isFirstItemColumnSpanned (self, QTreeWidgetItem?item) ``` 返回True如果給定的_item_被設置為只顯示一個對所有列部分，否則返回False 。 此功能被引入Qt的4.3 。 **See also** [setFirstItemColumnSpanned](qtreewidget.html#setFirstItemColumnSpanned)（ ） 。 ``` bool QTreeWidget.isItemExpanded (self, QTreeWidgetItem?item) ``` ``` bool QTreeWidget.isItemHidden (self, QTreeWidgetItem?item) ``` ``` bool QTreeWidget.isItemSelected (self, QTreeWidgetItem?item) ``` ``` bool QTreeWidget.isSortingEnabled (self) ``` ``` QTreeWidgetItem QTreeWidget.itemAbove (self, QTreeWidgetItem?item) ``` [ 返回上面給定的項目_item_。 此功能被引入Qt的4.3 。 ](qtreewidgetitem.html) ``` QTreeWidgetItem QTreeWidget.itemAt (self, QPoint?p) ``` [](qtreewidgetitem.html) [返回一個指針，指向了該項目的坐標_p_。該坐標是相對于樹部件的](qtreewidgetitem.html)[viewport()](qabstractscrollarea.html#viewport)。 **See also** [visualItemRect](qtreewidget.html#visualItemRect)（ ） 。 ``` QTreeWidgetItem QTreeWidget.itemAt (self, int?ax, int?ay) ``` [ 這是一個重載函數。 ](qtreewidgetitem.html) [返回一個指向該項目在坐標（_x_，_y_） 。該坐標是相對于樹部件的](qtreewidgetitem.html)[viewport()](qabstractscrollarea.html#viewport)。 ``` QTreeWidgetItem QTreeWidget.itemBelow (self, QTreeWidgetItem?item) ``` [ 返回目視低于給定的產品_item_。 此功能被引入Qt的4.3 。 ](qtreewidgetitem.html) ``` QTreeWidgetItem QTreeWidget.itemFromIndex (self, QModelIndex?index) ``` [](qtreewidgetitem.html) [返回一個指針](qtreewidgetitem.html)[QTreeWidgetItem](qtreewidgetitem.html)assocated用給定的_index_。 **See also** [indexFromItem](qtreewidget.html#indexFromItem)（ ） 。 ``` list-of-QTreeWidgetItem QTreeWidget.items (self, QMimeData?data) ``` ``` QWidget QTreeWidget.itemWidget (self, QTreeWidgetItem?item, int?column) ``` [ 返回由指定的單元格中顯示的小工具_item_和給定的_column_。 **Note:**樹取小部件的所有權。 這個函數是Qt 4.1中引入。 ](qwidget.html) [**See also**](qwidget.html) [setItemWidget](qtreewidget.html#setItemWidget)（ ） 。 ``` QMimeData QTreeWidget.mimeData (self, list-of-QTreeWidgetItem?items) ``` [ 該_QMimeData_結果 ](qmimedata.html) [返回一個對象，該對象包含指定的序列化描述_items_。用于描述的項目的格式是從所獲得的](qmimedata.html)[mimeTypes](qtreewidget.html#mimeTypes)（）函數。 如果項目列表為空，則返回0 ，而不是一個序列化的空單。 ``` QStringList QTreeWidget.mimeTypes (self) ``` 返回可用于描述treewidget項目清單的MIME類型的列表。 **See also** [mimeData](qtreewidget.html#mimeData)（ ） 。 ``` QTreeWidget.openPersistentEditor (self, QTreeWidgetItem?item, int?column?=?0) ``` 打開一個持久的編輯為_item_在給定的_column_。 **See also** [closePersistentEditor](qtreewidget.html#closePersistentEditor)（ ） 。 ``` QTreeWidget.removeItemWidget (self, QTreeWidgetItem?item, int?column) ``` 刪除給定的窗口部件集_item_在給定的_column_。 此功能被引入Qt的4.3 。 ``` QTreeWidget.scrollToItem (self, QTreeWidgetItem?item, QAbstractItemView.ScrollHint?hint?=?QAbstractItemView.EnsureVisible) ``` 這種方法也是一個Qt槽與C + +的簽名`void scrollToItem(const QTreeWidgetItem *,QAbstractItemView::ScrollHint = QAbstractItemView.EnsureVisible)`。 確保了_item_是可見的，滾動的視圖，如果必要使用指定的_hint_。 **See also** [currentItem](qtreewidget.html#currentItem)（ ）[itemAt](qtreewidget.html#itemAt)（）和[topLevelItem](qtreewidget.html#topLevelItem)（ ） 。 ``` list-of-QTreeWidgetItem QTreeWidget.selectedItems (self) ``` 返回所有選定的非隱藏物品的清單。 **See also** [itemSelectionChanged](qtreewidget.html#itemSelectionChanged)（ ） 。 ``` QTreeWidget.setColumnCount (self, int?columns) ``` ``` QTreeWidget.setCurrentItem (self, QTreeWidgetItem?item) ``` 設置當前_item_樹部件。 除非選擇模式為[NoSelection](qabstractitemview.html#SelectionMode-enum)時，該項目也被選中。 **See also** [currentItem](qtreewidget.html#currentItem)（）和[currentItemChanged](qtreewidget.html#currentItemChanged)（ ） 。 ``` QTreeWidget.setCurrentItem (self, QTreeWidgetItem?item, int?column) ``` 設置當前_item_在樹控件和當前列_column_。 這個函數是Qt 4.1中引入。 **See also** [currentItem](qtreewidget.html#currentItem)（ ） 。 ``` QTreeWidget.setCurrentItem (self, QTreeWidgetItem?item, int?column, QItemSelectionModel.SelectionFlags?command) ``` 設置當前_item_在樹控件和當前列_column_，使用給定的_command_。 此功能被引入Qt的4.4 。 **See also** [currentItem](qtreewidget.html#currentItem)（ ） 。 ``` QTreeWidget.setFirstItemColumnSpanned (self, QTreeWidgetItem?item, bool?span) ``` 設置給定_item_只顯示一個區段的所有列，如果_span_是真的，否則項目會顯示每列一個部分。 此功能被引入Qt的4.3 。 **See also** [isFirstItemColumnSpanned](qtreewidget.html#isFirstItemColumnSpanned)（ ） 。 ``` QTreeWidget.setHeaderItem (self, QTreeWidgetItem?item) ``` 該_item_說法有它的所有權轉移給Qt的。 設置頁眉_item_為樹部件。的標籤在報頭的每個列是由對應的標籤的產品供給。 樹部件采用該項目的所有權。 **See also** [headerItem](qtreewidget.html#headerItem)（）和[setHeaderLabels](qtreewidget.html#setHeaderLabels)（ ） 。 ``` QTreeWidget.setHeaderLabel (self, QString?alabel) ``` 同setHeaderLabels （[QStringList](qstringlist.html)（_label_））。 這個函數中引入了Qt 4.2中。 ``` QTreeWidget.setHeaderLabels (self, QStringList?labels) ``` 添加一列在每個項目的頭_labels_列出，并設置標籤為每一列。 需要注意的是setHeaderLabels （ ）不會刪除現有列。 **See also** [setHeaderItem](qtreewidget.html#setHeaderItem)（）和[setHeaderLabel](qtreewidget.html#setHeaderLabel)（ ） 。 ``` QTreeWidget.setItemExpanded (self, QTreeWidgetItem?item, bool?expand) ``` ``` QTreeWidget.setItemHidden (self, QTreeWidgetItem?item, bool?hide) ``` ``` QTreeWidget.setItemSelected (self, QTreeWidgetItem?item, bool?select) ``` ``` QTreeWidget.setItemWidget (self, QTreeWidgetItem?item, int?column, QWidget?widget) ``` 該_widget_說法有它的所有權轉移給Qt的。 設置給定_widget_要顯示在由給定的指定的單元_item_和_column_。 給定_widget_的[autoFillBackground](qwidget.html#autoFillBackground-prop)屬性必須設置為True，否則widget的背景是透明的，同時顯示模型數據和樹部件項目。 此功能只能用于顯示在一個樹控件選項的位置靜態內容。如果你想顯示自定義的動態內容或實現自定義編輯器部件，使用[QTreeView](qtreeview.html)和子類[QItemDelegate](qitemdelegate.html)代替。 這個函數不能被調用之前，該項目的層次結構已經成立，即[QTreeWidgetItem](qtreewidgetitem.html)將舉行_widget_必須被添加到視圖之前_widget_被設置。 **Note:**樹取小部件的所有權。 這個函數是Qt 4.1中引入。 **See also** [itemWidget](qtreewidget.html#itemWidget)（）和[Delegate Classes](index.htm#delegate-classes)。 ``` QTreeWidget.setSelectionModel (self, QItemSelectionModel?selectionModel) ``` 從重新實現[QAbstractItemView.setSelectionModel](qabstractitemview.html#setSelectionModel)（ ） 。 ``` QTreeWidget.setSortingEnabled (self, bool?enable) ``` ``` int QTreeWidget.sortColumn (self) ``` 返回用于widget的內容進行排序的列。 這個函數是Qt 4.1中引入。 **See also** [sortItems](qtreewidget.html#sortItems)（ ） 。 ``` QTreeWidget.sortItems (self, int?column, Qt.SortOrder?order) ``` 排序在指定的插件的項目_order_通過在給定的值_column_。 **See also** [sortColumn](qtreewidget.html#sortColumn)（ ） 。 ``` Qt.DropActions QTreeWidget.supportedDropActions (self) ``` [ 返回此視圖支持的放置動作。 ](index.htm) [**See also**](index.htm) [Qt.DropActions](qt.html#DropAction-enum)。 ``` QTreeWidgetItem QTreeWidget.takeTopLevelItem (self, int?index) ``` [ 該_QTreeWidgetItem_結果 刪除給定的頂級項目_index_在樹中，并返回它，否則返回0 ; ](qtreewidgetitem.html) [**See also**](qtreewidgetitem.html) [insertTopLevelItem](qtreewidget.html#insertTopLevelItem)（ ）[topLevelItem](qtreewidget.html#topLevelItem)（）和[topLevelItemCount](qtreewidget.html#topLevelItemCount-prop)（ ） 。 ``` QTreeWidgetItem QTreeWidget.topLevelItem (self, int?index) ``` [ 返回在給定的頂級項目_index_，或者0 ，如果該項目不存在。 ](qtreewidgetitem.html) [**See also**](qtreewidgetitem.html) [topLevelItemCount](qtreewidget.html#topLevelItemCount-prop)（）和[insertTopLevelItem](qtreewidget.html#insertTopLevelItem)（ ） 。 ``` int QTreeWidget.topLevelItemCount (self) ``` ``` QRect QTreeWidget.visualItemRect (self, QTreeWidgetItem?item) ``` [ 返回矩形上通過了該項目所佔用的視_item_。 ](qrect.html) [**See also**](qrect.html) [itemAt](qtreewidget.html#itemAt)（ ） 。 * * * ## Qt Signal Documentation ``` void currentItemChanged (QTreeWidgetItem *,QTreeWidgetItem *) ``` 這是該信號的默認超載。 在當前項目改變這個信號被發射。目前的項目是由指定的_current_，這取代了_previous_目前的項目。 **See also** [setCurrentItem](qtreewidget.html#setCurrentItem)（ ） 。 ``` void itemActivated (QTreeWidgetItem *,int) ``` 這是該信號的默認超載。 當用戶通過單或雙擊（取決于平臺上，即在啟動一個項目，這個信號被發射[QStyle.SH_ItemView_ActivateItemOnSingleClick](qstyle.html#StyleHint-enum)風格提示）或按下一個特殊鍵（例如，**Enter**） 。 指定_item_是被點擊，或者0，如果沒有項目被點擊的項目。該_column_是被點擊，或者-1，如果沒有項目被點擊項目的列。 ``` void itemChanged (QTreeWidgetItem *,int) ``` 這是該信號的默認超載。 這個信號被發射時的內容_column_在指定的_item_變化。 ``` void itemClicked (QTreeWidgetItem *,int) ``` 這是該信號的默認超載。 當用戶點擊窗口小部件里面這個信號被發射。 指定_item_是被單擊的項目。該_column_是被單擊的項目的列。如果沒有項目被點擊，無信號將被發射。 ``` void itemCollapsed (QTreeWidgetItem *) ``` 這是該信號的默認超載。 指定時，這個信號被發射_item_處于折疊狀態，使沒有它的孩子被顯示。 **Note:**如果一個項目改變它的狀態，該信號將不發射時[collapseAll](qtreeview.html#collapseAll)（）被調用。 **See also** [QTreeWidgetItem.isExpanded](qtreewidgetitem.html#isExpanded)（ ）[itemExpanded](qtreewidget.html#itemExpanded)（）和[collapseItem](qtreewidget.html#collapseItem)（ ） 。 ``` void itemDoubleClicked (QTreeWidgetItem *,int) ``` 這是該信號的默認超載。 這個信號被發射時的小部件內的用戶雙擊。 指定_item_是被點擊，或者0，如果沒有項目被點擊的項目。該_column_是被單擊的項目的列。如果沒有項目被雙擊時，無信號將被發射。 ``` void itemEntered (QTreeWidgetItem *,int) ``` 這是該信號的默認超載。 當鼠標光標進入了這個信號被發射_item_超過規定的_column_。[QTreeWidget](qtreewidget.html)鼠標跟蹤需要啟用此功能工作。 ``` void itemExpanded (QTreeWidgetItem *) ``` 這是該信號的默認超載。 指定時，這個信號被發射_item_是擴大，使所有的孩子都顯示出來。 **Note:**如果一個項目改變它的狀態，該信號將不發射時[expandAll](qtreeview.html#expandAll)（）被調用。 **See also** [setItemExpanded](index.htm#setItemExpanded)（ ）[QTreeWidgetItem.isExpanded](qtreewidgetitem.html#isExpanded)（ ）[itemCollapsed](qtreewidget.html#itemCollapsed)（）和[expandItem](qtreewidget.html#expandItem)（ ） 。 ``` void itemPressed (QTreeWidgetItem *,int) ``` 這是該信號的默認超載。 當用戶按下該插件內的鼠標按鈕，這個信號被發射。 指定_item_是被點擊，或者0，如果沒有項目被點擊的項目。該_column_是被點擊，或者-1，如果沒有項目被點擊項目的列。 ``` void itemSelectionChanged () ``` 這是該信號的默認超載。 當選擇樹部件改變這個信號被發射。當前的選擇可以與發現[selectedItems](qtreewidget.html#selectedItems)（ ） 。