qt QTreeWidget`总结

1. 基本概念

作用：用于显示树形结构的数据（如文件目录、层级菜单）。
核心组件 ：
- QTreeWidget：树形控件容器。
- QTreeWidgetItem：树形控件中的节点（可包含子节点）。

2. 基本用法

创建树控件

cpp 复制代码

QTreeWidget *treeWidget = new QTreeWidget(parent);
treeWidget->setColumnCount(2); // 设置列数
treeWidget->setHeaderLabels({"Name", "Value"}); // 设置表头

添加根节点和子节点

cpp 复制代码

// 添加根节点
QTreeWidgetItem *rootItem = new QTreeWidgetItem(treeWidget);
rootItem->setText(0, "Root");
rootItem->setData(0, Qt::UserRole, "CustomData"); // 存储自定义数据

// 添加子节点
QTreeWidgetItem *childItem = new QTreeWidgetItem(rootItem);
childItem->setText(0, "Child");
childItem->setCheckState(0, Qt::Checked); // 添加复选框

设置节点属性

cpp 复制代码

// 设置图标、字体、颜色等
childItem->setIcon(0, QIcon(":/icon.png"));
childItem->setForeground(0, QBrush(Qt::red));
childItem->setFlags(Qt::ItemIsEditable | Qt::ItemIsEnabled); // 允许编辑

3. 常用方法

数据操作

方法	描述
`addTopLevelItem(QTreeWidgetItem*)`	添加根节点
`insertTopLevelItem(int index, QTreeWidgetItem*)`	插入根节点到指定位置
`takeTopLevelItem(int index)`	移除根节点（不删除对象）
`clear()`	清空所有节点
`currentItem()`	获取当前选中节点

遍历节点

cpp 复制代码

// 遍历所有根节点
for (int i = 0; i < treeWidget->topLevelItemCount(); ++i) {
    QTreeWidgetItem *item = treeWidget->topLevelItem(i);
    // 遍历子节点
    for (int j = 0; j < item->childCount(); ++j) {
        QTreeWidgetItem *child = item->child(j);
    }
}

4. 信号与事件

常用信号

itemClicked(QTreeWidgetItem*, int column)：节点点击事件。
itemDoubleClicked(QTreeWidgetItem*, int column)：节点双击事件。
itemChanged(QTreeWidgetItem*, int column)：节点内容变化事件。

示例：响应点击事件

cpp 复制代码

connect(treeWidget, &QTreeWidget::itemClicked, [](QTreeWidgetItem *item, int col) {
    qDebug() << "点击节点：" << item->text(col);
});

5. 进阶功能

自定义排序

cpp 复制代码

// 按第一列文本排序
treeWidget->sortItems(0, Qt::AscendingOrder);

拖放支持

cpp 复制代码

treeWidget->setDragEnabled(true);
treeWidget->setAcceptDrops(true);
treeWidget->setDragDropMode(QAbstractItemView::InternalMove); // 内部拖放

样式定制

cpp 复制代码

// 使用 QSS 设置样式
treeWidget->setStyleSheet(
    "QTreeWidget { background: #f0f0f0; }"
    "QTreeWidget::item:hover { background: yellow; }"
);

与数据模型结合

对于复杂数据，可继承 QAbstractItemModel 使用 QTreeView，但 QTreeWidget 更适用于简单场景。

6. 示例代码

cpp 复制代码

// 创建树控件
QTreeWidget *tree = new QTreeWidget(this);
tree->setColumnCount(2);
tree->setHeaderLabels({"Category", "Status"});

// 添加根节点
QTreeWidgetItem *root = new QTreeWidgetItem(tree);
root->setText(0, "Animals");
root->setExpanded(true); // 默认展开

// 添加子节点
QTreeWidgetItem *child1 = new QTreeWidgetItem(root);
child1->setText(0, "Dog");
child1->setText(1, "Alive");

QTreeWidgetItem *child2 = new QTreeWidgetItem(root);
child2->setText(0, "Dinosaur");
child2->setText(1, "Extinct");

7. 注意事项

性能优化 ：大量节点时建议使用 QTreeView + QStandardItemModel。
内存管理 ：手动创建的 QTreeWidgetItem 需要手动删除（或设为子对象自动释放）。
线程安全：UI 操作需在主线程执行，多线程中通过信号槽更新数据。
数据存储 ：使用 setData() 和 data() 存储自定义数据，而非直接依赖文本。

掌握上述内容后，可以快速实现树形结构数据的展示与交互，并根据需求扩展高级功能（如动态加载、上下文菜单等）。