Qt QTreeWidget 详解

已于 2022-09-02 16:49:22 修改
阅读量1.3w 收藏 76
点赞数 14
CC 4.0 BY-SA版权
分类专栏： Qt 文章标签： qt ui QTreeWidget QTreeWidgetItem
于 2022-09-02 15:59:46 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/aoxuestudy/article/details/126662535
本文介绍了Qt中的QTreeWidget类，它提供了一个标准的树形小部件，适用于创建简单的分层列表。QTreeWidget基于Qt的模型/视图架构，允许使用默认项目模型。文中通过示例展示了如何创建和操作QTreeWidget，包括添加项目、设置列数、排序功能以及自定义头文件和右键菜单。此外，还提供了源码下载链接，帮助读者实践和理解QTreeWidget的使用。

Qt系列文章目录

文章目录

前言

官方文档
QTreeWidget类是一个方便的类,它提供了一个标准tree小部件与一个典型的基于项目所使用的接口类似QListView Qt 3类。这个类是基于Qt的模型/视图的体系结构,使用一个默认的模型项目,每一个都是一个QTreeWidgetItem。 　　 　　开发人员不需要模型/视图框架的灵活性可以使用这个类来创建简单的分层列表。更灵活的方法是结合QTreeView标准项目模型。这允许存储的数据是与它的表示分离。 在其最简单的形式,一个tree小部件可以构建在以下方式:

QTreeWidget *treeWidget = new QTreeWidget();
treeWidget->setColumnCount(1);
QList<QTreeWidgetItem *> items;
for (int i = 0; i < 10; ++i)
    items.append(new QTreeWidgetItem(static_cast<QTreeWidget *>(nullptr), QStringList(QString("item: %1").arg(i))));
treeWidget->insertTopLevelItems(0, items);

在这里插入图片描述
项目可以被添加到树小部件之前,列数必须设置与setColumnCount ()。这允许每个条目有一个或多个标签或其他装饰品。可以找到使用的列数与columnCount()函数。 　　 　　树可以有一个头,它包含一个部分每一列的小部件。是简单的设置标签为每个部分提供一个字符串列表与setHeaderLabels(),但可以构造一个自订标头QTreeWidgetItem和插入到树setHeaderItem()函数。 　　 　　树中的项目可以根据预定义的排序顺序按列排序。如果启用了排序,用户可以通过点击列标题的条目。通过调用setSortingEnabled排序可以启用或禁用()。isSortingEnabled()函数指示是否启用排序。

主要API

公共接口
在这里插入图片描述
主要信号槽函数
在这里插入图片描述

示例

运行效果
在这里插入图片描述

1.头文件：

#ifndef FORM_H
#define FORM_H

#include <QWidget>
#include <QTreeWidgetItem>
#include <QMenu>

namespace Ui {
class Form;
}

class Form : public QWidget
{
    Q_OBJECT

public:
    explicit Form(QWidget *parent = 0);
    ~Form();

public Q_SLOTS:
    void slotClicked(QTreeWidgetItem *item, int column);

    void slotMenuPopup(const QPoint &);

private:
    Ui::Form *ui;

    QMenu *m_menu = nullptr;
};

#endif // FORM_H

2.实现文件

#include "form.h"
#include "ui_form.h"
#include <QTreeWidgetItem>
#include <QDebug>

const QString styles = "QTreeView\
{\
    background-color: #5B677A;\
    font-size:17px;\
    color: white;\
}\
QTreeView::item:hover\
{\
    background: qlineargradient(x1: 0, y1: 0, x2: 0, y2: 1, stop: 0 #e7effd, stop: 1 #cbdaf1);\
    border: 1px solid #bfcde4;\
}\
QTreeView::item:hover\
{\
    background: rgb(69, 187, 217);\
}\
QTreeView::item:selected:active\
{\
    background: rgb(63, 147, 168);\
}\
QTreeView::item:selected:!active\
{\
    background: rgb(63, 147, 168);\
}\
QTreeView::branch\
{\
    background:#5B677A;\
}\
QTreeView::branch:has-children:!has-siblings:closed,QTreeView::branch:closed:has-children:has-siblings\
{\
    border-image: none;\
    background:#5B677A;\
    image: url(image/Folder-1.png);\
}\
QTreeView::branch:open:has-children:!has-siblings,QTreeView::branch:open:has-children:has-siblings\
{\
    border-image: none;\
    background:#5B677A;\
    image: url(image/Open-Folder.png);\
}";

Form::Form(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Form)
{
    ui->setupUi(this);

    //隐藏表头
    ui->treeWidget->setHeaderHidden(true);

    //打开右键菜单属性
    ui->treeWidget->setContextMenuPolicy(Qt::CustomContextMenu);

    //添加顶层节点
    QTreeWidgetItem *topItem1 = new QTreeWidgetItem(ui->treeWidget);
    topItem1->setText(0,u8"角色");
    topItem1->setCheckState(0, Qt::Checked);
    ui->treeWidget->addTopLevelItem(topItem1);

    //右键菜单
    m_menu = new QMenu(ui->treeWidget);
    m_menu->addAction(u8"添加");
    m_menu->addAction(u8"删除");

    QTreeWidgetItem *item11 = new QTreeWidgetItem(topItem1);
    item11->setText(0,u8"野蛮人");
    item11->setCheckState(0, Qt::Checked);
    //设置数据,可以带多种数据
    item11->setData(0,Qt::UserRole,100/*人员数量*/);
    item11->setData(0,Qt::UserRole+1,u8"肖恩"/*负责人名字*/);

    //获得数据
    item11->data(0,Qt::UserRole).toInt();
    item11->data(0,Qt::UserRole+1).toString();

    QTreeWidgetItem *item12 = new QTreeWidgetItem(topItem1);
    item12->setText(0,u8"猎魔人");
    QTreeWidgetItem *item13 = new QTreeWidgetItem(topItem1);
    item13->setText(0,u8"死灵法师");

    QTreeWidgetItem *item14 = new QTreeWidgetItem(topItem1);
    item14->setText(0,u8"圣骑士");

    QTreeWidgetItem *item15 = new QTreeWidgetItem(topItem1);
    item15->setText(0,u8"女巫");

    QTreeWidgetItem *item16 = new QTreeWidgetItem(topItem1);
    item16->setText(0,u8"武行者");

    QTreeWidgetItem *topItem2 = new QTreeWidgetItem(ui->treeWidget);
    topItem2->setText(0,u8"技能");
    topItem2->setCheckState(0,Qt::Checked);
    ui->treeWidget->addTopLevelItem(topItem2);

    QTreeWidgetItem *item21 = new QTreeWidgetItem(topItem2);
    item21->setText(0,u8"旋风斩");
    item21->setCheckState(0,Qt::Checked);
    QTreeWidgetItem *item22 = new QTreeWidgetItem(topItem2);
    item22->setText(0,u8"狂暴冲锋");
    item22->setCheckState(0,Qt::Checked);
    QTreeWidgetItem *item23 = new QTreeWidgetItem(topItem2);
    item23->setText(0,u8"不灭之怒");
    item23->setCheckState(0,Qt::Checked);

    QTreeWidgetItem *item24 = new QTreeWidgetItem(topItem2);
    item24->setText(0,u8"疾奔");
    item24->setCheckState(0,Qt::Checked);

    QTreeWidgetItem *item25 = new QTreeWidgetItem(topItem2);
    item25->setText(0,u8"狂乱");
    item25->setCheckState(0,Qt::Checked);

    QTreeWidgetItem *item26 = new QTreeWidgetItem(topItem2);
    item26->setText(0,u8"先祖之锤");
    item26->setCheckState(0,Qt::Checked);

    QTreeWidgetItem* childItem111 = new QTreeWidgetItem(item11);
    childItem111->setCheckState(0, Qt::Unchecked);
    childItem111->setText(0, u8"装备");

    QTreeWidgetItem* childItem1111 = new QTreeWidgetItem(childItem111);
    childItem1111->setText(0, u8"头盔");

    QTreeWidgetItem* childItem1112 = new QTreeWidgetItem(childItem111);
    childItem1112->setText(0, u8"胸甲");

    QTreeWidgetItem* childItem1113 = new QTreeWidgetItem(childItem111);
    childItem1113->setText(0, u8"肩甲");

    QTreeWidgetItem* childItem1114 = new QTreeWidgetItem(childItem111);
    childItem1114->setText(0, u8"裤子");

    QTreeWidgetItem* childItem1115 = new QTreeWidgetItem(childItem111);
    childItem1115->setText(0, u8"主手");

    QTreeWidgetItem* childItem1116 = new QTreeWidgetItem(childItem111);
    childItem1116->setText(0, u8"副手");




    //设置展开
    ui->treeWidget->expandAll();

    ui->treeWidget->setStyleSheet(styles);  //QTreeWidget

    connect(ui->treeWidget,&QTreeWidget::itemClicked,this,
            &Form::slotClicked);

    connect(ui->treeWidget,&QTreeWidget::customContextMenuRequested,
            this,&Form::slotMenuPopup);

}

Form::~Form()
{
    delete ui;
}

void Form::slotClicked(QTreeWidgetItem *item, int column)
{
    //简单响应一下选中状态槽函数
    int itemCount = item->childCount();
    for (int i=0; i<item->childCount(); i++)
    {
       QTreeWidgetItem *pChildItem = item->child(i);
       pChildItem->setCheckState(0,item->checkState(0));
    }
}

void Form::slotMenuPopup(const QPoint &pos)
{
    m_menu->exec(ui->treeWidget->mapToGlobal(pos));
}

UI
在这里插入图片描述

二、源码下载

源码下载地址

详解Qt 之 QTreeWidget
m0_62599305的博客
07-30 1076
在 Qt 框架中，是一个用于展示层级结构数据的强大控件。它允许开发者创建和管理树形结构的用户界面，特别适用于需要以树形结构组织信息的应用场景。比如，文件浏览器、菜单系统和项目管理器等，都可以利用来实现层级展示功能。本文将详细介绍的基本概念、功能、常用函数、信号和槽，并提供一个示例代码，帮助你更好地理解和应用这个控件。是 Qt 框架中的一个视图控件，继承自QTreeView。它提供了一个树形视图来展示数据，相比于QTreeView提供了内置的模型来简化树形数据的管理和操作。
QT QTreeWidget控件 全面详解
断点
01-23 399
本文详细的介绍了QToolButton控件的各种操作，例如 头文件、创建控件、按钮文本、获取文本、设置文本、按钮状态、按钮状态、按钮可用、启用按钮、启用、禁用、禁用按钮、禁用、启用、按钮图标、设置、获取、按钮长宽、按钮Size、获取最大值 最小值、设置最大值 最小值、几何信息、获取几何信息、设置几何信息、Object对象、父控件对象、样式表、设置样式表、获取样式表、信号槽、点击信号、按下信号、释放信号、其它信号 等等操作。有相关问题请联系 Dream.2017@qq.com。
QTreeWidget——信号处理
qq_15672897的博客
08-17 5011
QTreeWidget信号触发测试
Qt树形表格控件QTreeWidget的使用：添加自定义列表项
qq_40876689的博客
08-24 8676
Qt使用QTreeWidget控件，添加自定义列表项！
qtreeview和qtreewidget的区别 使用总结 和选择
biao2488890051的博客
10-06 7708
QStandardItemModel是qt提供了的，就是子类化的QAbstractItemModel。而我们使用的话，不再子类化QStandardItemModel，而是子类化QAbstractItemModel。子类化的话，需要重写里面很多虚函数，目的是告诉模型你如何提供这些函数的功能。举个例，重写rowCount(parent)函数，根据parent返回子行的数目，如果需求比较变态，我就是想根据不同的parent的特征返回不同的孩子数（不管实际孩子数是不是这么多），那么就要重写这个函数了。
Qt TreeWidget详细说明
qq_71286244的博客
05-22 2306
Qt TreeWidget详细用法分析。
Qt QTreeWidget详解
芒种、的博客
12-23 4980
Qt中实现树形结构可以使用QTreeWidget类，也可以使用QTreeView类，QTreeWidget继承自QTreeView类。 一、常用属性（可通过设计器直接设置） 函数 作用 header()->setVisible(false); 设置标题头是否显示 header()->setDefaultSectionSize(200); 设置标题头默认的尺寸 void setSortingEnabled(bool enable); 设置点击标题头排序 void set
Qt QTreeWidget树形控件用法详解_qt 树控件
2401_86963447的博客
09-12 1421
type 参数通常不需要手动指定，保持默认即可。QTreeWidgetItem 还提供了很多实用的成员方法，下表罗列了一些常用的方法。借助它们，我们可以轻松地管理 QTreeWidget 控件中的各个结点。表 1 QTreeWidgetItem常用成员方法 成员方法 功 能关于表中这些成员方法的具体用法，本文后续会大家结合实例进行讲解。
第一篇 QT QTreeWidget 和 QTreeWidgetItem
P15050251827的博客
10-30 378
建议版本，后续有空，会进行扩展与更新，有问题可以评论或私信。
Qt QTreeWidget 简单易学的例子
05-19
Qt QTreeWidget 简单易学的例子 已经经过调试，可以运行！
【Qt笔记】QTreeWidget控件详解
qq_52924376的博客
09-05 9455
QTreeWidget 是 Qt 框架中用于展示层次化数据的一个非常强大的控件，它继承自 QAbstractItemView 和 QTreeView，但提供了更为简便的接口来管理树形结构的数据。
Qt QTreeWidget 树形结构实现(一)
夜影轩的专栏
08-01 1万+
Qt中实现树形结构可以使用QTreeWidget类，也可以使用QTreeView类，QTreeWidget继承自QTreeView类。树形效果如下图所示： 这是怎么实现的呢？还有点击节点时会有相应的事件响应。 1. 树形结构实现 QT GUI中有treeWidget部件，将该控件在Gui中布局好，假设其对象名为treeWidget。 QTreeWidget类官方文档：http://qt
【QT学习七】QTreeWidget
热门推荐
从此不归路
04-04 1万+
QTreeWidget是Qt中一个用于显示树形结构数据的控件，它继承自QTreeView，可以显示多列数据和树形结构的层次关系，还提供了许多交互功能。可以支持单选、多选和可编辑的节点，还可以自定义节点的样式和布局。除此之外，QTreeWidget 还支持信号和槽机制，可以方便地处理节点的操作事件，如点击、双击、选择等等。头文件: #include <QTreeWidget>继承: QTreeViewQTreeWidget 的节点可以根据需求进行自定义样式的设置。
【qt】QTreeWidget 树形组件
qq_74047911的博客
05-19 2630
树形组件，我们可以想象一下我们的文件或者qt左侧的项目。对对对，就类似于这样！还是老样子，我们跟着项目来上图：来吧，开干！树形组件，类似于文件的样式，主要是注意初始化的时候，添加的是那个目录。人的一切痛苦，本质上都是对自己无能的愤怒。
Qt之目录树组件QTreeWidget
weixin_44875787的博客
05-12 1613
QTreeWidget的常规使用，如添加根节点、子节点，设置节点文本、图标、属性标记、角色数据等； （2）动态添加子节点，本文上限设置成了7级； （3）右键点击节点添加、删除节点功能；
Qt QTreeWidget树形控件用法详解
qq_41854911的博客
11-24 5953
通过先将 item 和 item2 添加到 items 容器中，然后再将 items 传递给 treeWidget 对象的 addTopLevelItems() 方法，就可以将 items 容器中的所有结点添加到 treeWidget 控件中，作为该控件的顶层结点。图 2 中显示的数字 1，是 QTreeWidget 控件中的表头，默认情况下 QTreeWidget 只有一个表头，表头的内容就是 1。当为新建 QTreeWidget 对象指定父窗口后，它将作为该窗口中的一个控件（如图 2a) ）；
QT笔记——QTreeWidget
lion_cxq的博客
01-25 508
头文件： #include<QTreeWidget> 代码段： ui->treeWidget->setColumnCount(1); //设置列数 ui->treeWidget->setHeaderLabel(QStringLiteral("树的示例")); //设置头的标题 QTreeWidgetItem *tree1 = new QTreeWidgetItem(ui->treeWidget,QStringList(QStringLiteral("树1")))
【嵌入式——QT】QTreeWidget
weixin_39723539的博客
03-04 2393
嵌入式-QT-QTreeWidget
PyQt5中QTreeWidget详解
最新发布
09-17
<think> 我们被要求详细介绍PyQt5中的QTreeWidget。根据之前的引用和用户需求，我们需要涵盖以下内容： 1. QTreeWidget的基本概念和用途 2. 如何创建和填充QTreeWidget（包括添加顶级项和子项） 3. 遍历QTreeWidget（参考引用[1]） 4. 设置项的外观（如图标、文本对齐方式，参考引用[2]和[4]） 5. 实现右键菜单（参考引用[3]） 6. 其他常用功能（如信号、事件等） 我们将按照以下结构组织回答： 一、QTreeWidget概述 二、创建QTreeWidget并添加项 三、遍历QTreeWidget 四、设置项的外观 五、实现右键菜单 六、其他常用功能 七、总结 注意：我们将使用中文，并适当添加代码示例，同时注意引用标记。 </think> # PyQt5 QTreeWidget 组件详解 QTreeWidget是PyQt5中用于展示树形结构数据的核心组件，它继承自QTreeView，提供了更高级的树形数据展示功能。以下是对QTreeWidget的全面解析： ## 一、QTreeWidget 基础概念 ### 1.1 树形结构基本元素 QTreeWidget的核心结构由以下元素组成： - **树控件**：作为整体容器 - **顶级项**(Top-level items)：树的根节点 - **子项**(Child items)：节点下的分支 - **列**(Columns)：每个节点可以有多列数据 树结构的数学表示： $$ \text{Tree} = \{ \text{Root}, \text{Children}(\text{Root}) \} \\ \text{Children}(n) = \{ c_1, c_2, \dots, c_k \mid c_i \text{是} n \text{的子节点} \} $$ ### 1.2 核心类关系 ```mermaid classDiagram QWidget <|-- QTreeView QTreeView <|-- QTreeWidget QTreeWidget o-- QTreeWidgetItem QTreeWidgetItem o-- QTreeWidgetItem ``` ## 二、创建与基本操作 ### 2.1 初始化树控件 ```python from PyQt5.QtWidgets import QTreeWidget, QTreeWidgetItem tree = QTreeWidget() tree.setColumnCount(3) # 设置列数 tree.setHeaderLabels(["名称", "类型", "大小"]) # 设置列标题 ``` ### 2.2 添加树节点 ```python # 创建顶级项 root_item = QTreeWidgetItem(tree) root_item.setText(0, "根节点") # 添加子项 child_item = QTreeWidgetItem(root_item) child_item.setText(0, "子节点1") # 批量添加 child_items = [ QTreeWidgetItem(["子节点2", "文件", "10KB"]), QTreeWidgetItem(["子节点3", "文件夹", ""]) ] root_item.addChildren(child_items) ``` ### 2.3 遍历树结构 遍历所有节点的高效方法参考[^1]： ```python def iterate_tree(widget): """递归遍历树的所有节点""" root = widget.invisibleRootItem() child_count = root.childCount() for i in range(child_count): item = root.child(i) process_item(item, 0) def process_item(item, level): """处理单个节点""" indent = " " * level print(f"{indent}{item.text(0)}") # 递归处理子节点 for i in range(item.childCount()): child = item.child(i) process_item(child, level + 1) ``` ## 三、节点定制化 ### 3.1 设置图标与样式 ```python from PyQt5.QtGui import QIcon # 设置图标 folder_icon = QIcon("folder.png") file_icon = QIcon("file.png") root_item.setIcon(0, folder_icon) child_item.setIcon(0, file_icon) # 文本对齐方式（参考[^4]） child_item.setTextAlignment(2, Qt.AlignRight) # 第三列右对齐 ``` ### 3.2 节点属性设置 ```python # 设置可选中、可编辑等属性 item.setFlags(item.flags() | Qt.ItemIsEditable) # 设置状态 item.setCheckState(0, Qt.Checked) # 添加复选框 item.setDisabled(True) # 禁用节点 ``` ### 3.3 动态调整大小 根据内容自动调整列宽参考[^2]： ```python tree.header().setSectionResizeMode(QHeaderView.ResizeToContents) ``` ## 四、交互功能实现 ### 4.1 右键菜单实现 实现右键上下文菜单参考[^3]： ```python from PyQt5.QtWidgets import QMenu, QAction class CustomTreeWidget(QTreeWidget): def __init__(self): super().__init__() self.setContextMenuPolicy(Qt.CustomContextMenu) self.customContextMenuRequested.connect(self.show_context_menu) def show_context_menu(self, pos): item = self.itemAt(pos) if not item: return menu = QMenu(self) action1 = QAction("重命名", self) action2 = QAction("删除", self) menu.addAction(action1) menu.addAction(action2) action1.triggered.connect(lambda: self.rename_item(item)) action2.triggered.connect(lambda: self.delete_item(item)) menu.exec_(self.mapToGlobal(pos)) ``` ### 4.2 信号处理 ```python # 节点展开/折叠 tree.itemExpanded.connect(lambda item: print(f"{item.text(0)} 展开")) tree.itemCollapsed.connect(lambda item: print(f"{item.text(0)} 折叠")) # 节点选择变化 tree.itemSelectionChanged.connect(lambda: print("选择改变")) # 节点双击 tree.itemDoubleClicked.connect(lambda item, col: print(f"双击: {item.text(col)}")) ``` ## 五、高级功能 ### 5.1 排序与筛选 ```python # 启用排序 tree.setSortingEnabled(True) tree.sortItems(0, Qt.AscendingOrder) # 按第一列升序排列 # 自定义筛选 tree.setHeaderHidden(False) # 显示表头 tree.header().setSectionsClickable(True) tree.header().sectionClicked.connect(self.sort_by_column) def sort_by_column(self, logical_index): tree.sortItems(logical_index, tree.header().sortIndicatorOrder()) ``` ### 5.2 数据持久化 ```python # 保存树状态 def save_state(self): state = [] root = self.invisibleRootItem() for i in range(root.childCount()): item = root.child(i) state.append({ "text": [item.text(col) for col in range(3)], "expanded": item.isExpanded(), "child_count": item.childCount() }) return state # 恢复树状态 def restore_state(self, state): for item_data in state: item = QTreeWidgetItem(item_data["text"]) item.setExpanded(item_data["expanded"]) self.addTopLevelItem(item) ``` ## 六、性能优化技巧 ### 6.1 大数据量处理 当处理大量节点时： ```python tree.setUniformRowHeights(True) # 提高滚动性能 tree.setUpdatesEnabled(False) # 批量更新时禁用刷新 # 批量添加节点... tree.setUpdatesEnabled(True) # 完成后启用刷新 ``` ### 6.2 虚拟模式 对于超大数据集使用模型/视图分离： ```python model = QStandardItemModel() tree_view = QTreeView() tree_view.setModel(model) ``` ## 七、应用场景 QTreeWidget适用于： 1. 文件浏览器（展示目录结构） 2. 配置界面（分组设置项） 3. 数据库导航（表/字段层次） 4. XML/JSON树形数据显示 5. 组织结构展示（部门/人员）
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值