Qt TreeWidget详细说明

一.定义

Qt的TreeWidget是一个用于展示树状数据的控件，可以显示带有父子关系的数据。TreeWidget可以包括一列或多列数据，并且可以提供用户对数据进行展开和折叠的功能。

TreeWidget中的数据是以树的形式展示的，每个节点可以包含子节点，用户可以通过展开和折叠节点来查看或隐藏子节点的数据。TreeWidget还支持对节点进行排序和过滤等操作。

二.主要属性

columnCount：设置TreeWidget的列数，用于显示多列数据。
headerLabels：设置TreeWidget的列头标签，用于指定每列的标题。
dragEnabled：设置是否允许拖拽操作。
dropIndicatorShown：设置是否显示拖放指示器。
editTriggers：设置何时允许用户编辑单元格的内容。
sortingEnabled：设置是否允许排序。
rootIsDecorated：设置根节点是否显示展开/折叠的标志。
alternateRowColors：设置是否使用交替行颜色。
selectionMode：设置选择模式，如单选、多选等。
currentitem：获取当前选择的项。
topLevelItemCount：获取顶层项的数量。
topLevelItem：获取指定索引处的顶层项。

三.主要方法

addItem(QTreeWidgetItem *item)：向TreeWidget中添加一个项。
headerItem()：返回TreeWidget的列头项。
setColumnCount(int columns)：设置TreeWidget的列数。
setHeaderLabels(const QStringList &labels)：设置TreeWidget的列头标签。
expandAll()：展开所有项。
collapseAll()：折叠所有项。
topLevelItem(int index)：返回指定索引处的顶层项。
setCurrentItem(QTreeWidgetItem *item)：设置当前选择的项。
takeTopLevelItem(int index)：移除并返回指定索引处的顶层项。
clear()：清空TreeWidget中的所有项。
sortItems(int column, Qt::SortOrder order)：根据指定列对项进行排序。
findItems(const QString &text, Qt::MatchFlags flags, int column)：查找包含指定文本的项。
setHeaderItem()方法用于设置QTreeWidget的头标签。

1. `setHeaderItem()用法分析`

setHeaderItem()方法用于设置QTreeWidget的头标签。该方法接受一个QTreeWidgetItem对象作为参数，该对象表示头标签。以下是关于setHeaderItem()方法的详细分析和解释：

创建一个QTreeWidgetItem对象，用于表示头标签。您可以设置该项的文本、图标等属性。

使用setText()方法设置头标签的文本。例如，可以使用setText(0, "Header Label")将头标签的文本设置为"Header Label"。

使用setHeaderItem()方法将创建的头标签QTreeWidgetItem对象设置为QTreeWidget的头标签。这样就可以在树形控件的顶部显示设置的头标签。

QTreeWidgetItem* headerItem = new QTreeWidgetItem();
headerItem->setText(0, "Header Label");
ui->treeWidget->setHeaderItem(headerItem);

setHeaderItem()方法只能设置QTreeWidget的第一列的头标签，如果想要设置多列的头标签，需要使用setHeaderLabels()方法来设置所有列的标题。setHeaderLabels()方法接受一个QStringList对象作为参数，其中包含要设置的所有列的标题。

四.主要信号

itemClicked(QTreeWidgetItem *item, int column)：当用户点击项时发出信号。
itemDoubleClicked(QTreeWidgetItem *item, int column)：当用户双击项时发出信号。
itemChanged(QTreeWidgetItem *item, int column)：当项的内容发生改变时发出信号。
itemSelectionChanged()：当选择的项发生变化时发出信号。
currentItemChanged(QTreeWidgetItem *current, QTreeWidgetItem *previous)：当当前项发生变化时发出信号。
itemExpanded(QTreeWidgetItem *item)：当项展开时发出信号。
itemCollapsed(QTreeWidgetItem *item)：当项折叠时发出信号。
itemActivated(QTreeWidgetItem *item, int column)：当项被激活（例如通过双击或回车键）时发出信号。
itemEntered(QTreeWidgetItem *item, int column)：当鼠标进入项时发出信号。
itemPressed(QTreeWidgetItem *item, int column)：当鼠标按压在项上时发出信号。

五.案例分析

代码如下：

#include <QApplication>
#include <QTreeWidget>
#include <QTreeWidgetItem>int main(int argc, char *argv[])
{QApplication app(argc, argv);// 创建一个TreeWidget控件QTreeWidget treeWidget;treeWidget.setWindowTitle("Tree Widget Example");// 设置TreeWidget的列数treeWidget.setColumnCount(2);// 添加树的头部项QStringList headers;headers << "Name" << "Value";treeWidget.setHeaderLabels(headers);// 创建根节点QTreeWidgetItem *rootItem = new QTreeWidgetItem(&treeWidget);rootItem->setText(0, "Root");// 创建子节点QTreeWidgetItem *childItem1 = new QTreeWidgetItem(rootItem);childItem1->setText(0, "Child 1");childItem1->setText(1, "Value 1");QTreeWidgetItem *childItem2 = new QTreeWidgetItem(rootItem);childItem2->setText(0, "Child 2");childItem2->setText(1, "Value 2");// 将节点添加到TreeWidget中treeWidget.addTopLevelItem(rootItem);// 显示TreeWidget控件treeWidget.show();return app.exec();
}