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. 注意事项

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

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

相关推荐
文牧之15 分钟前
PostgreSQL 用户资源管理
运维·数据库·postgresql
李长渊哦1 小时前
深入理解 JavaScript 中的全局对象与 JSON 序列化
开发语言·javascript·json
若水晴空初如梦1 小时前
QT聊天项目DAY06
开发语言·qt
h汉堡3 小时前
C++入门基础
开发语言·c++·学习
HtwHUAT3 小时前
实验四 Java图形界面与事件处理
开发语言·前端·python
鄃鳕3 小时前
QSS【QT】
开发语言·qt
汤姆_5113 小时前
【c语言】深度理解指针4——sizeof和strlen
c语言·开发语言
碎梦归途3 小时前
23种设计模式-结构型模式之外观模式(Java版本)
java·开发语言·jvm·设计模式·intellij-idea·外观模式
muyouking114 小时前
4.Rust+Axum Tower 中间件实战:从集成到自定义
开发语言·中间件·rust
FAREWELL000754 小时前
C#进阶学习(九)委托的介绍
开发语言·学习·c#·委托