QTreeWidget 应用场景与用法详解

原创 已于 2025-06-08 17:33:42 修改 · 931 阅读 · 18 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#qt

于 2025-06-08 17:33:18 首次发布

一、QTreeWidget概述

QTreeWidget是Qt框架中用于显示树形结构数据的核心控件，它继承自QTreeView，提供了基于项的接口，比QTreeView更易用但灵活性稍低。它能够以层次结构展示数据，是构建复杂UI界面的重要组件。

二、典型应用场景

1. 文件系统浏览器

// 创建文件系统树
QTreeWidget *fileTree = new QTreeWidget;
fileTree->setHeaderLabels({"名称", "大小", "修改日期"});

QTreeWidgetItem *root = new QTreeWidgetItem(fileTree);
root->setText(0, "C:/");
root->setIcon(0, QIcon(":/icons/drive.png"));

// 添加文件夹
QTreeWidgetItem *documents = new QTreeWidgetItem(root);
documents->setText(0, "Documents");
documents->setIcon(0, QIcon(":/icons/folder.png"));

// 添加文件
QTreeWidgetItem *file = new QTreeWidgetItem(documents);
file->setText(0, "report.pdf");
file->setText(1, "2.4 MB");
file->setIcon(0, QIcon(":/icons/pdf.png"));

2. 配置设置界面

// 创建配置树
QTreeWidget *settingsTree = new QTreeWidget;
settingsTree->setHeaderHidden(true);

QTreeWidgetItem *appearance = new QTreeWidgetItem(settingsTree);
appearance->setText(0, "外观设置");

QTreeWidgetItem *theme = new QTreeWidgetItem(appearance);
theme->setText(0, "主题");
theme->setCheckState(0, Qt::Checked);

QTreeWidgetItem *font = new QTreeWidgetItem(appearance);
font->setText(0, "字体大小");

3. 数据分类展示

// 产品分类树
QTreeWidget *categoryTree = new QTreeWidget;
categoryTree->setColumnCount(2);
categoryTree->setHeaderLabels({"分类", "产品数量"});

QTreeWidgetItem *electronics = new QTreeWidgetItem(categoryTree);
electronics->setText(0, "电子产品");
electronics->setText(1, "128");

QTreeWidgetItem *phones = new QTreeWidgetItem(electronics);
phones->setText(0, "手机");
phones->setText(1, "42");

QTreeWidgetItem *laptops = new QTreeWidgetItem(electronics);
laptops->setText(0, "笔记本电脑");
laptops->setText(1, "35");

4. 项目组织结构图

// 公司组织结构树
QTreeWidget *orgTree = new QTreeWidget;
orgTree->setHeaderLabels({"部门", "负责人", "人数"});

QTreeWidgetItem *ceo = new QTreeWidgetItem(orgTree);
ceo->setText(0, "CEO办公室");
ceo->setText(1, "张明");
ceo->setText(2, "5");

QTreeWidgetItem *rd = new QTreeWidgetItem(ceo);
rd->setText(0, "研发部");
rd->setText(1, "李华");
rd->setText(2, "32");

QTreeWidgetItem *sales = new QTreeWidgetItem(ceo);
sales->setText(0, "销售部");
sales->setText(1, "王芳");
sales->setText(2, "28");

三、核心功能与用法

1. 基本操作

// 创建树控件
QTreeWidget *tree = new QTreeWidget(parent);
tree->setColumnCount(3); // 设置列数
tree->setHeaderLabels({"列1", "列2", "列3"}); // 设置标题

// 添加顶级项
QTreeWidgetItem *topItem = new QTreeWidgetItem(tree);
topItem->setText(0, "顶级项");

// 添加子项
QTreeWidgetItem *childItem = new QTreeWidgetItem(topItem);
childItem->setText(0, "子项");
childItem->setCheckState(0, Qt::Unchecked); // 添加复选框

// 设置图标
topItem->setIcon(0, QIcon(":/icons/folder.png"));

// 展开所有项
tree->expandAll();

// 折叠所有项
tree->collapseAll();

2. 数据操作

// 获取选中项
QList<QTreeWidgetItem*> selectedItems = tree->selectedItems();

// 遍历所有项
QTreeWidgetItemIterator it(tree);
while (*it) {
    qDebug() << (*it)->text(0);
    ++it;
}

// 查找特定项
QList<QTreeWidgetItem*> foundItems = tree->findItems("搜索文本", Qt::MatchExactly | Qt::MatchRecursive, 0);

// 删除项
if (selectedItems.count() > 0) {
    delete selectedItems.first();
}

3. 信号处理

// 项选择变化
connect(tree, &QTreeWidget::itemSelectionChanged, [=](){
    qDebug() << "选择发生变化";
});

// 项展开/折叠
connect(tree, &QTreeWidget::itemExpanded, [=](QTreeWidgetItem *item){
    qDebug() << "展开:" << item->text(0);
});

// 项双击
connect(tree, &QTreeWidget::itemDoubleClicked, [=](QTreeWidgetItem *item, int column){
    qDebug() << "双击:" << item->text(column);
});

// 项改变（如复选框状态）
connect(tree, &QTreeWidget::itemChanged, [=](QTreeWidgetItem *item, int column){
    if (column == 0 && item->checkState(0) == Qt::Checked) {
        qDebug() << "选中:" << item->text(0);
    }
});

4. 样式定制

/* 基本树控件样式 */
QTreeWidget {
    background-color: #FFFFFF;
    border: 1px solid #E0E0E0;
    font-size: 12px;
}

/* 表头样式 */
QHeaderView::section {
    background-color: #F5F7FA;
    padding: 6px;
    border: none;
    border-bottom: 1px solid #E4E7ED;
}

/* 项样式 */
QTreeWidget::item {
    height: 28px;
    border-bottom: 1px solid #F0F0F0;
}

/* 选中项样式 */
QTreeWidget::item:selected {
    background-color: #FFF7F0;
    color: #1D2129;
}

/* 分支指示器（三角图标）样式 */
QTreeWidget::branch {
    background-color: transparent;
    width: 16px;
    height: 16px;
}

QTreeWidget::branch:closed::indicator {
    image: url(:/icons/triangle-right.svg);
}

QTreeWidget::branch:open::indicator {
    image: url(:/icons/triangle-down.svg);
}

四、高级功能实现

1. 自定义委托

class ProgressBarDelegate : public QStyledItemDelegate {
public:
    void paint(QPainter *painter, const QStyleOptionViewItem &option,
               const QModelIndex &index) const override {
        if (index.column() == 2) { // 第三列显示进度条
            int progress = index.data().toInt();
            
            QStyleOptionProgressBar progressBarOption;
            progressBarOption.rect = option.rect;
            progressBarOption.minimum = 0;
            progressBarOption.maximum = 100;
            progressBarOption.progress = progress;
            progressBarOption.text = QString::number(progress) + "%";
            progressBarOption.textVisible = true;
            
            QApplication::style()->drawControl(
                QStyle::CE_ProgressBar, &progressBarOption, painter);
        } else {
            QStyledItemDelegate::paint(painter, option, index);
        }
    }
};

// 使用委托
tree->setItemDelegateForColumn(2, new ProgressBarDelegate);

2. 拖放功能

// 启用拖放
tree->setDragEnabled(true);
tree->setAcceptDrops(true);
tree->setDragDropMode(QAbstractItemView::InternalMove);

// 实现拖放事件
void MyTreeWidget::dropEvent(QDropEvent *event) {
    QTreeWidgetItem *target = itemAt(event->pos());
    if (!target) return;
    
    QTreeWidgetItem *dragged = currentItem();
    if (dragged && dragged != target) {
        // 创建副本
        QTreeWidgetItem *newItem = dragged->clone();
        // 添加到目标
        target->addChild(newItem);
        // 删除原始项
        delete dragged;
    }
}

3. 上下文菜单

tree->setContextMenuPolicy(Qt::CustomContextMenu);
connect(tree, &QTreeWidget::customContextMenuRequested, 
        this, &MyWidget::showContextMenu);

void MyWidget::showContextMenu(const QPoint &pos) {
    QTreeWidgetItem *item = tree->itemAt(pos);
    if (!item) return;
    
    QMenu menu;
    QAction *renameAction = menu.addAction("重命名");
    QAction *deleteAction = menu.addAction("删除");
    
    QAction *selected = menu.exec(tree->viewport()->mapToGlobal(pos));
    if (selected == renameAction) {
        tree->editItem(item);
    } else if (selected == deleteAction) {
        delete item;
    }
}

五、性能优化技巧

  1. 批量操作优化

    tree->setUpdatesEnabled(false); // 开始批量操作
for (int i = 0; i < 1000; ++i) {
    QTreeWidgetItem *item = new QTreeWidgetItem(tree);
    item->setText(0, QString("Item %1").arg(i));
}
tree->setUpdatesEnabled(true); // 结束批量操作

  2. 延迟加载

    connect(tree, &QTreeWidget::itemExpanded, [=](QTreeWidgetItem *item) {
    if (item->childCount() == 0) { // 首次展开时加载
        loadChildren(item);
    }
});

  3. 使用模型/视图架构处理大数据
    当数据量超过1000项时，考虑使用QTreeView + QAbstractItemModel

  4. 合理设置列宽

    tree->header()->setSectionResizeMode(0, QHeaderView::Stretch); // 第一列自适应
tree->header()->setSectionResizeMode(1, QHeaderView::Fixed);   // 第二列固定宽度
tree->header()->resizeSection(1, 100);

六、最佳实践总结

  1. 层次结构设计原则

    • 保持树结构不超过4层深度
    • 每层节点数不超过100个
    • 使用清晰的图标区分不同类型

  2. 用户体验优化

    • 提供搜索过滤功能
    • 添加右键上下文菜单
    • 实现拖放排序
    • 支持复选框多选

  3. 性能与稳定性

    • 大数据集使用懒加载
    • 避免在主线程进行复杂操作
    • 使用信号阻塞防止递归事件
    • 及时释放不再使用的项

  4. 样式与主题

    • 使用样式表统一外观
    • 适配不同平台风格
    • 提供高对比度模式支持
    • 确保选中状态清晰可见
【QT开发】树形控件QTreeWidget类详解及实战应用
科技改变人类，技术成就未来
07-07 2408
QTreeWidget是Qt提供的一个功能强大且灵活的树形控件类，通过本篇文章的学习，你应该对QTreeWidget有了全面的理解，能够在自己的项目中正确使用它。QTreeWidget在用户界面中帮助你更好地展示和管理层次化数据，实现交互式和响应式的数据展示，有助于创建用户友好和高效的目录树浏览器、项目管理工具等应用场景。
【QT】QTreeWidget控件的使用
u011671745的博客
12-18 2812
本文介绍QTreeWidget控件的使用，包括QTreeWidget控件常用功能接口和实例功能介绍，且与相应的资源绑定，可进行调试学习。
Qt QTreeWidget树形控件用法详解
qq_41854911的博客
11-24 5881
通过先将 item 和 item2 添加到 items 容器中，然后再将 items 传递给 treeWidget 对象的 addTopLevelItems() 方法，就可以将 items 容器中的所有结点添加到 treeWidget 控件中，作为该控件的顶层结点。图 2 中显示的数字 1，是 QTreeWidget 控件中的表头，默认情况下 QTreeWidget 只有一个表头，表头的内容就是 1。当为新建 QTreeWidget 对象指定父窗口后，它将作为该窗口中的一个控件（如图 2a) ）；
QTreeWidget的简单用法
w_ww_w的专栏
10-14 810
转载于: http://www.cnblogs.com/venow/archive/2012/10/16/2726587.html #include #include #include #include #include int main(int argc, char *argv[]) {     QApplication a(argc, argv);
QT之QTreeWidget的使用
热门推荐
愤怒的狸猫 的博客
02-27 2万+
QTreeWidget使用 QTreeWidget的基本使用 创建基础QTreeWidget ui->treeWidget->setColumnCount(3); ui->treeWidget->setHeaderLabels(QStringList()<<"编号"<<"启用"<<"描述"); QList<QString> allItemName{"10","否","第一层Item"}; //创建顶层Item QTre
QTreeWidget的使用
qq_36659059的博客
07-07 1005
QTreeWidget的使用 日期 作者 版本 说明 2021年7月7日 Mister H V1.0 QTreeWidget的基本用法 目录QTreeWidget的使用QTreeWidget的基本用法1. 添加元素2. 删除节点1. 单个节点删除2. 两个相同节点同步删除（在不同的父节点下）：3. 获取当前节点内容4.获取某一个分支的子节点QTreeWidget保存调用过程保存打开 QTreeWidget的基本用法 1. 添加元素 添加节点元素，首先得有一个父节点，然后往下面添加子节点，
QTreeWidget的使用示例
modi000的博客
08-22 2784
1、QTreeWidget中列的含义： 在setColumnCounts中有示例： 即，treeWidget中也是可以有多列的。 ui->treeWidget->setColumnCount(2); QTreeWidgetItem *p,*q; p = new QTreeWidgetItem(ui->treeWidget,QStringList("mm")); p->setText(1,"22"); ui->treeWidg.
Qt QTreeWidget树形控件用法详解_qt 树控件
最新发布
2501_90433399的博客
02-03 1660
图 1 是树形结构的一个典型示例，MyFirstQt 项目的内部构成一目了然，项目内部包含一个 MyFirstQt.pro 项目文件和 3 个文件夹，每个文件夹中包含哪些文件也都可以清楚地看到。作为一款成熟的 GUI 框架，Qt 提供了 QTreeWidget 树形控件，专门用来以树形结构显示数据。
掌握QTreeWidget：添加和删除操作详解
QTreeWidget是Qt框架中用于创建树形控件的一个类，它继承自QWidget，并提供了丰富的API来实现复杂的树形结构视图。它常用于展示和管理具有层次...在实际开发中，开发者需要根据具体的应用场景进行适当的扩展和定制。
QT之QTableWidget基本使用
01-06
#include widget.h #include ui_widget.h #include Widget::Widget(QWidget *parent) : QWidget(parent), ui(new Ui::Widget) { ui->setupUi(this); //tableWidget表格控件使用 //设置列数 ui->tableWidget->setColumnCount(3); //设置水平表头 ui->tableWidget->setHorizontalHeaderLabels(QStringLis
QTreeWidget简单使用
12-28
代码示例演示了QTreeWidget的简单使用（最顶层的项用addTopLevelItem()函数来加入，每个项的子项用addChild()函数来加入），结合使用这两个API构建属于自己的树控件。使用QTreeWidgetItem的setIcon()函数可以给每个项设置图标，界面更美观。。。
Qt|QTreewidget类下函数qt助手详解说明示例（二）
奇树谦的博客
07-14 1144
QWidget。
Qt QTreeWidget树形控件用法详解_qt 树控件(1)
2401_87019153的博客
09-07 1270
已剪辑自: http://c.biancheng.net/view/vip_9659.htmlQTreeWidget 是 Qt 框架提供的一种树形控件，它能以树形结构展示数据（或者文件）之间的包含关系。举个简单的例子，下图是我们创建好的一个 Qt 项目：[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fMzezztO-1669280924164)(http://c.biancheng.net/uploads/allimg/211028/16394RH8-0.gif)]
[QT_012]Qt学习之QTreeWidget 详解
kongcheng253的博客
01-09 1万+
QTreeWidget
【QT学习七】QTreeWidget
从此不归路
04-04 1万+
QTreeWidget是Qt中一个用于显示树形结构数据的控件，它继承自QTreeView，可以显示多列数据和树形结构的层次关系，还提供了许多交互功能。可以支持单选、多选和可编辑的节点，还可以自定义节点的样式和布局。除此之外，QTreeWidget 还支持信号和槽机制，可以方便地处理节点的操作事件，如点击、双击、选择等等。头文件: #include <QTreeWidget>继承: QTreeViewQTreeWidget 的节点可以根据需求进行自定义样式的设置。
[QT]QTreeWidget 的基本用法
阳光柠檬_的技术笔记
10-31 1万+
QTreeWidget用法实例： void MainWindow::QTreeWidgetTest() { ui->treeWidget->setColumnCount(2); ui->treeWidget->setHeaderLabels(QStringList()<<"one"<<"two"); AddRoot("hello", "world"); AddChild(itm,"one
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

极地星光

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值