QTreeWidget 类

另见 insertTopLevelItem。

void QTreeWidget::addTopLevelItems(const QList<QTreeWidgetItem *> &items)

将项目列表添加为小部件的顶级项目。

参见 insertTopLevelItems()。

[slot] void QTreeWidget::clear()

清除树小部件，通过移除所有项目及选择。

注意：由于每个项目在删除前都从树小部件中移除，因此从项目的析构函数中调用QTreeWidgetItem::treeWidget()时，其返回值将是无效的。

参见 takeTopLevelItem()、topLevelItemCount() 以及 columnCount()。

void QTreeWidget::closePersistentEditor(QTreeWidgetItem *item, int column = 0)

关闭给定列中项目的持久编辑器。

如果为该项和列打开持久编辑器，则此函数无任何效果。

参见 openPersistentEditor() 和 isPersistentEditorOpen()。

[slot] void QTreeWidget::collapseItem(const QTreeWidgetItem *item)

关闭 item。这将导致包含此项目子项的树折叠。

参见 expandItem()、currentItem()、itemAt() 以及 topLevelItem()。

int QTreeWidget::currentColumn() const

返回树小部件中的当前列。

参见 setCurrentItem() 和 columnCount()。

QTreeWidgetItem *QTreeWidget::currentItem() const

返回树小部件中的当前项。

参见 setCurrentItem() 和 currentItemChanged()。

[signal] void QTreeWidget::currentItemChanged(QTreeWidgetItem *current, QTreeWidgetItem *previous)

当当前项发生变化时发出此信号。当前项由 current 指定，并用它来替换 previous 当前项。

参见 setCurrentItem()。

[override virtual protected] void QTreeWidget::dropEvent(QDropEvent *event)

重新实现: QAbstractItemView::dropEvent(QDropEvent *event)

[虚拟保护] bool QTreeWidget::dropMimeData(QTreeWidgetItem *parent, int index, const QMimeData *data, Qt::DropAction action)

处理由拖放操作提供的数据，该操作在给定 index 的 parent 项中以给定的 action 结束。

默认实现如果通过解码 mime 数据并将其插入到模型中成功处理了放置，则返回 true；否则返回 false。

另请参阅 supportedDropActions()。

void QTreeWidget::editItem(QTreeWidgetItem *item, int column = 0)

如果它可以编辑，则开始编辑给定 column 中的 item。

[重写虚保护] bool QTreeWidget::event(QEvent *e)

重实现了： QAbstractItemView::event(QEvent *event)。

[槽] void QTreeWidget::expandItem(const QTreeWidgetItem *item)

展开 item。这会导致包含 item 子项的树展开。

另请参阅 collapseItem()，currentItem()，itemAt()，topLevelItem() 以及 itemExpanded()。

QList<QTreeWidgetItem *> QTreeWidget::findItems(const QString &text, Qt::MatchFlags flags, int column = 0) const

返回与给定 text 匹配的项目列表，使用给定的 flags 和给定 column。

QModelIndex QTreeWidget::headerItem() const

返回用于树小部件标题的项。

另请参阅 setHeaderItem()。

QModelIndex QTreeWidget::indexFromItem(const QTreeWidgetItem *item, int column = 0) const

返回与给定 item 关联的 QModelIndex，在给定的 column 中。

另请参阅 itemFromIndex() 和 topLevelItem()。

int QTreeWidget::indexOfTopLevelItem(QTreeWidgetItem *item) const

返回给定顶层项目的索引，如果找不到项目则返回-1。

另请参阅sortItems() 和 topLevelItemCount()。

void QTreeWidget::insertTopLevelItem(int index, QTreeWidgetItem *item)

在视图的顶层将项目插入到索引。

如果项目已 elsewhere 插入，则不会插入。

另请参阅addTopLevelItem() 和 columnCount()。

void QTreeWidget::insertTopLevelItems(int index, const QList<QTreeWidgetItem *> &items)

在视图的顶层将项目列表插入到索引。

如果项目已 elsewhere 插入，则不会插入。

另请参阅addTopLevelItems()。

QTreeWidgetItem *QTreeWidget::invisibleRootItem() const

返回树小部件的不可见根项目。

不可见根项目提供了通过 QTreeWidgetItem API 访问树小部件顶层项目的方法，使得可以编写统一处理顶层项目和其子项目的函数；例如，递归函数。

bool QTreeWidget::isPersistentEditorOpen(QTreeWidgetItem *item, int column = 0) const

返回在列 column 的项目 item 是否有一个持久编辑器是打开的。

另请参阅openPersistentEditor() 和 closePersistentEditor()。

QTreeWidgetItem *QTreeWidget::itemAbove(const QTreeWidgetItem *item) const

返回给定 项目 上方的项目。

[信号] void QTreeWidget::itemActivated(QTreeWidgetItem *item, int column)

当用户通过单次或双击（根据平台，即通过 QStyle::SH_ItemView_ActivateItemOnSingleClick 风格提示）或按特殊键（例如，Enter）激活项目时，会发出此信号。

指定的 项目 是被点击的项目，如果没有点击任何项目则 nullptr。 列 是被点击的项目列，如果没有点击任何项目则 -1。

QTreeWidgetItem *QTreeWidget::itemAt(const QPoint &p) const

返回指向坐标p处项目的指针。坐标相对于树小部件的视口。

另请参阅visualItemRect()。

QTreeWidgetItem *QTreeWidget::itemAt(int x, int y) const

这是一个重载函数。

返回坐标（x，y）处的项目的指针。坐标相对于树小部件的视口。

QTreeWidgetItem *QTreeWidget::itemBelow(const QTreeWidgetItem *item) const

返回给定 item 下可视的项目。

[信号] void QTreeWidget::itemChanged(QTreeWidgetItem *item, int column)

当指定 item 的 column 中的内容发生变化时，发出此信号。

[信号] void QTreeWidget::itemClicked(QTreeWidgetItem *item, int column)

当用户在部件内部点击时，发出此信号。

指定的 item 是被点击的项目。 column 是被点击的项目列。如果没有点击任何项目，则不会发出信号。

[信号] void QTreeWidget::itemCollapsed(QTreeWidgetItem *item)

当指定的 item 被折叠而使其子项都不显示时，发出此信号。

另请参阅：QTreeWidgetItem::isExpanded()，itemExpanded()，以及collapseItem()。

[信号] void QTreeWidget::itemDoubleClicked(QTreeWidgetItem *item, int column)

当用户在部件内部双击时，发出此信号。

指定的 item 是被点击的项目，如果没有点击任何项目，则为 nullptr。 column 是被点击的项目列。如果没有双击任何项目，则不会发出信号。

[信号] void QTreeWidget::itemEntered(QTreeWidgetItem *item, int column)

当鼠标光标进入指定 column 上的 item 时，发出此信号。 QTreeWidget 需要启用鼠标跟踪功能才能使用此功能。

[信号] void QTreeWidget::itemExpanded(QTreeWidgetItem *item)

当指定的 item 被展开以显示所有子项时，发出此信号。

参见 QTreeWidgetItem::isExpanded()、itemCollapsed() 和 expandItem()。

QTreeWidgetItem *QTreeWidget::itemFromIndex(const QModelIndex &index) const

返回与给定 index 相关的 QTreeWidgetItem 指针。

参见 indexFromItem()。

[信号] void QTreeWidget::itemPressed(QTreeWidgetItem *item, int column)

当用户在控件内按下鼠标按钮时，发出此信号。

指定的 项目 是被点击的项目，如果没有点击任何项目则 nullptr。 列 是被点击的项目列，如果没有点击任何项目则 -1。

[信号] void QTreeWidget::itemSelectionChanged()

当树控件中的选择改变时，发出此信号。可以使用 selectedItems() 查找当前选择。

QWidget *QTreeWidget::itemWidget(QTreeWidgetItem *item, int column) const

返回在指定 item 和给定的 column 指定的单元格中显示的控件。

参见 setItemWidget()。

[虚保护] QMimeData *QTreeWidget::mimeData(const QList<QTreeWidgetItem *> &items) const

返回一个包含指定 items 序列化描述的对象。用于描述项的格式是从 mimeTypes() 函数获得的。

如果项列表为空，返回 nullptr 而不是序列化的空列表。

[虚保护] QStringList QTreeWidget::mimeTypes() const

返回可以用于描述树项列表的 MIME 类型列表。

参见 mimeData()。

void QTreeWidget::openPersistentEditor(QTreeWidgetItem *item, int column = 0)

打开给定 column 中 item 的持久性编辑器。

参见 closePersistentEditor() 和 isPersistentEditorOpen()。

void QTreeWidget::removeItemWidget(QTreeWidgetItem *item, int column)

删除在给定 item 和给定 column 中设定的控件。

[槽] void QTreeWidget::scrollToItem(const QTreeWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible)

确保项目可见，如果需要，使用指定的提示滚动视图。

另请参阅 currentItem()，itemAt() 和 topLevelItem()。

QList<QTreeWidgetItem> QTreeWidget::selectedItems() const

返回所有选中的非隐藏项目的列表。

另请参阅 itemSelectionChanged。

void QTreeWidget::setCurrentItem(QTreeWidgetItem *item)

设置树形控件中的当前项目。

除非选择模式为 NoSelection，否则也会选中该项目。

另请参阅 currentItem() 和 currentItemChanged()。

void QTreeWidget::setCurrentItem(QTreeWidgetItem *item, int column)

设置树形控件中的当前项目，并将当前列设置为 column。

另请参阅 currentItem。

void QTreeWidget::setCurrentItem(QTreeWidgetItem *item, int column, QItemSelectionModel::SelectionFlags command)

使用给定的 command 设置树形控件中的当前项目，并将当前列设置为 column。

另请参阅 currentItem。

void QTreeWidget::setHeaderItem(QTreeWidgetItem *item)

设置树形控件的标题 item。标题中每一列的标签由项目的相应标签提供。

树形控件将拥有该项目的所有权。

另请参阅 headerItem() 和 setHeaderLabels()。

void QTreeWidget::setHeaderLabel(const QString &label)

等同于 setHeaderLabels(QStringList(label))。

void QTreeWidget::setHeaderLabels(const QStringList &labels)

在每个 labels 列表中为每个项目在标题中添加一个列，并为每个列设置标签。

注意，setHeaderLabels() 不会删除现有列。

另请参阅 setHeaderItem() 和 setHeaderLabel()。

void QTreeWidget::setItemWidget(QTreeWidgetItem *item, int column, QWidget *widget)

将给定的 widget 设置为显示在由给定的 item 和 column 指定的单元格中。

给定的 widget 的 autoFillBackground 属性必须设置为 true，否则 widget 的背景将是透明的，将显示模型数据和树形控件项目。

此函数应仅用于在树小部件项的占位符中显示静态内容。如果您想显示自定义动态内容或实现自定义编辑小部件，请使用QTreeView并派生自QStyledItemDelegate。

在设置项层次结构之前不能调用此函数，即，在设置widget之前必须先将持有widget的QTreeWidgetItem添加到视图中。

另请参阅：itemWidget() 和代理类。

[重载虚函数] void QTreeWidget::setSelectionModel(QItemSelectionModel *selectionModel)

重实现了： QTreeView::setSelectionModel(QItemSelectionModel *selectionModel)。

int QTreeWidget::sortColumn() const

返回用于对 widget 内容进行排序的列。

另请参阅：sortItems。

void QTreeWidget::sortItems(int column, Qt::SortOrder order)

按指定order按给定column中的值对 widget 中的项进行排序。

另请参阅：sortColumn。

[虚保护] Qt::DropActions QTreeWidget::supportedDropActions() const

返回此视图支持的拖放操作。

另请参阅：Qt::DropActions。

QTreeWidgetItem *QTreeWidget::takeTopLevelItem(int index)

从树中移除给定index的位置的顶层项并返回它，否则返回nullptr；

另请参阅：insertTopLevelItem，topLevelItem和topLevelItemCount。

QTreeWidgetItem *QTreeWidget::topLevelItem(int index) const

返回给定index的顶层项，如果该项不存在，则返回nullptr。

另请参阅：topLevelItemCount和insertTopLevelItem。

QRect QTreeWidget::visualItemRect(const QTreeWidgetItem *item) const

返回占据视图中item位置的矩形。

另请参阅：itemAt。