Qt 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);
1
2
3
4
5
6

项目可以被添加到树小部件之前,列数必须设置与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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

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));
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179

UI

二、源码下载

源码下载地址