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() 存储自定义数据,而非直接依赖文本。

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

相关推荐
hqxstudying1 小时前
Java异常处理
java·开发语言·安全·异常
wjs20244 小时前
状态模式(State Pattern)
开发语言
我命由我123454 小时前
Kotlin 数据容器 - List(List 概述、创建 List、List 核心特性、List 元素访问、List 遍历)
java·开发语言·jvm·windows·java-ee·kotlin·list
liulilittle4 小时前
C++ TAP(基于任务的异步编程模式)
服务器·开发语言·网络·c++·分布式·任务·tap
励志要当大牛的小白菜6 小时前
ART配对软件使用
开发语言·c++·qt·算法
-SGlow-8 小时前
MySQL相关概念和易错知识点(2)(表结构的操作、数据类型、约束)
linux·运维·服务器·数据库·mysql
爱装代码的小瓶子8 小时前
数据结构之队列(C语言)
c语言·开发语言·数据结构
明月5669 小时前
Oracle 误删数据恢复
数据库·oracle
Maybe_ch9 小时前
.NET-键控服务依赖注入
开发语言·c#·.net
超浪的晨9 小时前
Java UDP 通信详解:从基础到实战,彻底掌握无连接网络编程
java·开发语言·后端·学习·个人开发