【Qt6】列表模型——树形列表

QStandardItemModel 类作为标准模型，主打“类型通用”，前一篇水文中，老周还没提到树形结构的列表，本篇咱们就好好探讨一下这货。
还是老办法，咱们先做示例，然后再聊知识点。下面这个例子，使用 QTreeView 组件来显示数据，使用的列表模型比较简单，只有一列。

1. #include <QApplication>
2. #include <QTreeView>
3. #include <QStandardItem>
4. #include <QStandardItemModel>
6. int main(int argc, char* argv[])
7. {
8.     QApplication app(argc, argv);
10.     // 创建组件实例
11.     QTreeView *viewWind = new QTreeView(nullptr);
12.     // 创建数据模型
13.     QStandardItemModel* model;
14.     model = new QStandardItemModel(viewWind);
15.     // 顶级节点
16.     QStandardItem* top1 = new QStandardItem("工程部");
17.     // 添加子节点
18.     top1->setChild(0/*行号*/, new QStandardItem("螺母组"));
19.     top1->setChild(1, new QStandardItem("电钻组"));
21.     // 继续添加顶层节点
22.     QStandardItem *top2 = new QStandardItem("情报部");
23.     // 添加子节点
24.     top2->setChild(0, new QStandardItem("偷窥组"));
25.     top2->setChild(1, new QStandardItem("监听组"));
27.     // 把两个顶层节点添加到模型中
28.     model->setItem(0/*行号*/, top1);
29.     model->setItem(1, top2);
30.     // 将模型应用到视图
31.     viewWind->setModel(model);
32.     // 显示视图窗口
33.     viewWind->show();
35.     return QApplication::exec();
36. }

复制代码

最先添加到 QStandarItemModel 的 QStandardItem 被视为树的顶层节点。调用顶层节点的 setChild 方法会添加子节点。从数据模型的角度看，子节点可以是一个二维表，即可以指定行号和列号的。不过，上面这个示例咱们只用了一列，即列号一直是0，所以调用的重载方法只需指定行号即可。其签名如下：

1. void setChild(int arow, QStandardItem *aitem)

复制代码

arow 参数指定的是行的索引，要将子项放在第一行就传 0，放在第二行就传1，等等。此重载版本忽略了列号。
QStandardItem 对象之间建立好层次关系后，最终还要添加到 QStandardItemModel 中的，不然前面的工夫就白做了——数据当然要放进模型中的嘛。
当模型准备好后，调用视图组件的 setModel 方法呈现模型数据。

1. viewWind->setModel(model);

复制代码

最终效果可以看下图：

你可能会疑惑：左上角那个“1”是什么鬼？那个鬼是列号，咱们这例子只有一列，所以显示了默认列号。一般单列数据不需要列标题，可以将其隐藏。

1. viewWind->setHeaderHidden(true);

复制代码

true 表示隐藏行、列标题，false 表示显示标题。
这样看起来就顺眼多了。

 
Qt 的 TreeView 有一点很不错，就是可以显示多列。比如，下面这个例子，列表项包含三列。

1. #include <QApplication>
2. #include <QStandardItem>
3. #include <QStandardItemModel>
4. #include <QTreeView>
6. int main(int argc, char* argv[])
7. {
8.     QApplication app(argc, argv);
10.     // 视图
11.     QTreeView* view = new QTreeView;
12.     // 模型
13.     QStandardItemModel *model = new QStandardItemModel;
15.     // 顶层节点1
16.     QStandardItem* root1 = new QStandardItem("普通班");
17.     // 添加子节点
18.     // 第一行
19.     QStandardItem* sub11 = new QStandardItem("230566");
20.     QStandardItem* sub12 = new QStandardItem("小齐");
21.     QStandardItem* sub13 = new QStandardItem("老齐");
22.     root1->setChild(0, 0, sub11);
23.     root1->setChild(0, 1, sub12);
24.     root1->setChild(0,2, sub13);
25.     // 第二行，可以直接插入QStandardItem实例
26.     root1->setChild(1, 0, new QStandardItem("230524"));
27.     root1->setChild(1, 1, new QStandardItem("小王"));
28.     root1->setChild(1, 2, new QStandardItem("隔壁老王"));
29.     // 添加到模型中
30.     model->setItem(0, root1);
32.     // 添加顶层节点2
33.     // 可以直接设置，不声明变量
34.     model->setItem(1, new QStandardItem("VIP班"));
35.     // 添加子项
36.     // 第一行
37.     model->item(1, 0)->setChild(0,0,new QStandardItem("2309291"));
38.     model->item(1, 0)->setChild(0,1,new QStandardItem("小曾"));
39.     model->item(1, 0)->setChild(0,2,new QStandardItem("老曾"));
40.     // 第二行
41.     model->item(1, 0)->setChild(1,0,new QStandardItem("2307266"));
42.     model->item(1, 0)->setChild(1, 1,new QStandardItem("小郑"));
43.     model->item(1, 0)->setChild(1,2,new QStandardItem("老郑"));
45.     // 顶层节点3
46.     model->setItem(2, new QStandardItem("神童班"));
47.     // 第一行
48.     model->item(2, 0)->setChild(0,0,new QStandardItem("23061685"));
49.     model->item(2, 0)->setChild(0,1, new QStandardItem("小季"));
50.     model->item(2, 0)->setChild(0, 2,new QStandardItem("扯牛堂认证医师老季"));
51.     // 第二行
52.     model->item(2, 0)->setChild(1,0,new QStandardItem("23064217"));
53.     model->item(2, 0)->setChild(1,1,new QStandardItem("小陆"));
54.     model->item(2, 0)->setChild(1,2,new QStandardItem("老陆"));
55.     // 第三行
56.     model->item(2, 0)->setChild(2,0, new QStandardItem("23031982"));
57.     model->item(2, 0)->setChild(2,1,new QStandardItem("小严"));
58.     model->item(2, 0)->setChild(2,2,new QStandardItem("严嵩第11代孙"));
60.     // 设置列标题
61.     model->setHorizontalHeaderLabels({"学号", "姓名", "家长代表"});
62.     // 把模型设置到视图
63.     view->setModel(model);
64.     view->setWindowTitle("厚黑幼儿园");
65.     // 显示视图
66.     view->show();
68.     return QApplication::exec();
69. }

复制代码

虽然在列表模型中，每个 QStandardItem 都可以把整个二维表作为子节点，而且任意行、列处的项都可以拥有子节点。但是，QTreeView 视图只允许第一列出现折叠效果，所以，对于可折叠的父节点，咱们用一列就可以了，就算设置了多列也没有效果的。不妨想一下，如果每个单元格都可以折叠，那么不仅这控件设计起来困难，而看起来也很混乱，用户没法用了。所以，QTreeView 只认第一列可以折叠。
model 的 setHorizontalHeaderLabels 方法用来设置水平方向上的标题，参数是一个字符串列表。水平方向就是列标题；如果是行标题，就是垂直方向，要调用 setVerticalHeaderLabels 方法。不过，行标题一般不怎么用，顶多显示行号。
最终显示的效果如下：

这个可以显示多列的 TreeView 真的很不错，可惜 .NET 中的 WinForms 和 WPF 自带控件 TreeView 没有这个玩法。
 

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！