Qt TreeWidget常用方法详解

一.设置头标签

当我们需要在QTreeWidget中显示头标签时，我们有两种选择：setHeaderItem()和setHeaderLabels()。下面我将详细解释这两种方法，并举例说明它们的用法。

1.使用setHeaderItem()方法设置头标签：（只能设置第一个标签）

通过创建一个QTreeWidgetItem对象表示头标签。

使用setText()方法设置头标签的文本。

将QTreeWidgetItem对象作为参数传递给setHeaderItem()方法，以设置头标签。

cpp 复制代码

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

使用 setHeaderLabels() 方法设置头标签：（可设置多个）

创建一个QStringList对象，其中包含要设置的标题。

调用setHeaderLabels()方法并传递QStringList对象作为参数来设置头标签。

cpp 复制代码

QStringList headers;
headers << "Header 1" << "Header 2" << "Header 3";
ui->treeWidget->setHeaderLabels(headers);

通过上述示例，您可以看到如何使用setHeaderItem()和setHeaderLabels()方法设置QTreeWidget的头标签。前者适用于单列头标签，后者适用于多列头标签。

二.设置顶层结点

要在QTreeWidget中设置顶层节点，您可以使用QTreeWidgetItem的addChild()方法或者直接使用addTopLevelItem()方法。下面我将详细解释这两种方法，并分别用示例说明如何设置顶层节点。

1.使用QTreeWidgetItem的addChild()方法设置顶层节点：

创建一个QTreeWidgetItem对象表示顶层节点。

使用setText()方法设置顶层节点的文本。

使用addChild()方法向QTreeWidget添加顶层节点。

cpp 复制代码

QTreeWidgetItem* topLevelItem = new QTreeWidgetItem(ui->treeWidget);
topLevelItem->setText(0, "Top Level Item 1");

QTreeWidgetItem* childItem = new QTreeWidgetItem(topLevelItem);
childItem->setText(0, "Child Item 1");

（补充）setText()方法用于设置QTreeWidgetItem（树控件中的项目）的文本内容。该方法接受两个参数：

第一个参数是一个整数，表示要设置文本的列索引。对于单列的树控件，通常将此参数设置为0；对于多列的树控件，可以指定要设置文本的列索引。

第二个参数是一个字符串，表示要设置的文本内容。

2.使用addTopLevelItem()方法设置顶层节点：

创建一个QTreeWidgetItem对象表示顶层节点。

使用setText()方法设置顶层节点的文本。

使用addTopLevelItem()方法将顶层节点添加到QTreeWidget。

cpp 复制代码

QTreeWidgetItem* topLevelItem = new QTreeWidgetItem(ui->treeWidget);
topLevelItem->setText(0, "Top Level Item 1");

QTreeWidgetItem* childItem = new QTreeWidgetItem(topLevelItem);
childItem->setText(0, "Child Item 1");

三.设置孩子结点

在QTreeWidget中设置子节点（孩子结点）的方式类似于设置顶层节点，您可以使用QTreeWidgetItem的addChild()方法或直接在父节点上使用addChild()方法。

下面我将详细解释这两种方法，并分别用示例说明如何设置子节点：

1.使用QTreeWidgetItem直接指定的方法设置子节点：（不需要手动添加）

创建一个父节点QTreeWidgetItem对象。

使用QTreeWidgetItem(ui->treeWidget)方法创建一个子节点并添加到父节点。

使用setText()方法设置子节点的文本。

cpp 复制代码

QTreeWidgetItem* parentItem = new QTreeWidgetItem(ui->treeWidget);
parentItem->setText(0, "Parent Item");

QTreeWidgetItem* childItem = new QTreeWidgetItem(parentItem);
childItem->setText(0, "Child Item 1");

2.在父节点上直接使用addChild()方法设置子节点：（需要手动添加）

创建一个父节点QTreeWidgetItem对象。

直接在父节点上调用addChild()方法创建一个子节点。

使用setText()方法设置子节点的文本。

cpp 复制代码

QTreeWidgetItem* parentItem = new QTreeWidgetItem(ui->treeWidget);
parentItem->setText(0, "Parent Item");

parentItem->addChild(new QTreeWidgetItem(parentItem, QStringList("Child Item 1")));

四.删除结点

要删除QTreeWidget中的子节点，可以使用takeChild()方法或removeChild()方法。下面我将介绍这两种方法的用法，并提供示例来演示如何删除子节点：

1.使用takeChild()方法删除子节点：

使用父节点的takeChild()方法删除指定位置的子节点。

通过delete操作符彻底释放内存。

cpp 复制代码

// 删除第一个孩子结点
QTreeWidgetItem* parentItem = ui->treeWidget->topLevelItem(0); // 获取父节点
QTreeWidgetItem* childItem = parentItem->takeChild(0);         // 获取要删除的孩子结点
delete childItem;  // 释放内存

2.使用removeChild()方法删除子节点：

使用父节点的removeChild()方法删除指定位置的子节点，不需要手动释放内存，Qt会自动处理。

cpp 复制代码

// 删除第一个孩子结点
QTreeWidgetItem* parentItem = ui->treeWidget->topLevelItem(0); // 获取父节点
QTreeWidgetItem* childItem = parentItem->child(0);             // 获取要删除的孩子结点
parentItem->removeChild(childItem);  // 删除孩子结点，Qt会自动释放内存

通过takeChild()方法或removeChild()方法，您可以在QTreeWidget中删除特定位置的子节点。请注意，在takeChild()方法中，您需要手动释放内存，而在removeChild()方法中，Qt会在删除子节点时自动释放内存。

记住在删除子节点之前，要确保首先获取到正确的父节点和要删除的子节点。这样您可以有效地操作QTreeWidget中的子节点并进行删除操作。