【Qt6】列表模型——树形列表
QStandardItemModel 类作为标准模型，主打“类型通用”，前一篇水文中，老周还没提到树形结构的列表，本篇咱们就好好探讨一下这货。
还是老办法，咱们先做示例，然后再聊知识点。下面这个例子，使用 QTreeView 组件来显示数据，使用的列表模型比较简单，只有一列。
#include <QApplication> #include <QTreeView> #include <QStandardItem> #include <QStandardItemModel> int main(int argc, char* argv[]) { QApplication app(argc, argv); // 创建组件实例 QTreeView *viewWind = new QTreeView(nullptr); // 创建数据模型 QStandardItemModel* model; model = new QStandardItemModel(viewWind); // 顶级节点 QStandardItem* top1 = new QStandardItem("工程部"); // 添加子节点 top1->setChild(0/*行号*/, new QStandardItem("螺母组")); top1->setChild(1, new QStandardItem("电钻组")); // 继续添加顶层节点 QStandardItem *top2 = new QStandardItem("情报部"); // 添加子节点 top2->setChild(0, new QStandardItem("偷窥组")); top2->setChild(1, new QStandardItem("监听组")); // 把两个顶层节点添加到模型中 model->setItem(0/*行号*/, top1); model->setItem(1, top2); // 将模型应用到视图 viewWind->setModel(model); // 显示视图窗口 viewWind->show(); return QApplication::exec(); }
最先添加到 QStandarItemModel 的 QStandardItem 被视为树的顶层节点。调用顶层节点的 setChild 方法会添加子节点。从数据模型的角度看，子节点可以是一个二维表，即可以指定行号和列号的。不过，上面这个示例咱们只用了一列，即列号一直是0，所以调用的重载方法只需指定行号即可。其签名如下：
void setChild(int arow, QStandardItem *aitem)
arow 参数指定的是行的索引，要将子项放在第一行就传 0，放在第二行就传1，等等。此重载版本忽略了列号。
QStandardItem 对象之间建立好层次关系后，最终还要添加到 QStandardItemModel 中的，不然前面的工夫就白做了——数据当然要放进模型中的嘛。
当模型准备好后，调用视图组件的 setModel 方法呈现模型数据。
viewWind->setModel(model);
最终效果可以看下图：
你可能会疑惑：左上角那个“1”是什么鬼？那个鬼是列号，咱们这例子只有一列，所以显示了默认列号。一般单列数据不需要列标题，可以将其隐藏。
viewWind->setHeaderHidden(true);
true 表示隐藏行、列标题，false 表示显示标题。
这样看起来就顺眼多了。
Qt 的 TreeView 有一点很不错，就是可以显示多列。比如，下面这个例子，列表项包含三列。
#include <QApplication> #include <QStandardItem> #include <QStandardItemModel> #include <QTreeView> int main(int argc, char* argv[]) { QApplication app(argc, argv); // 视图 QTreeView* view = new QTreeView; // 模型 QStandardItemModel *model = new QStandardItemModel; // 顶层节点1 QStandardItem* root1 = new QStandardItem("普通班"); // 添加子节点 // 第一行 QStandardItem* sub11 = new QStandardItem("230566"); QStandardItem* sub12 = new QStandardItem("小齐"); QStandardItem* sub13 = new QStandardItem("老齐"); root1->setChild(0, 0, sub11); root1->setChild(0, 1, sub12); root1->setChild(0,2, sub13); // 第二行，可以直接插入QStandardItem实例 root1->setChild(1, 0, new QStandardItem("230524")); root1->setChild(1, 1, new QStandardItem("小王")); root1->setChild(1, 2, new QStandardItem("隔壁老王")); // 添加到模型中 model->setItem(0, root1); // 添加顶层节点2 // 可以直接设置，不声明变量 model->setItem(1, new QStandardItem("VIP班")); // 添加子项 // 第一行 model->item(1, 0)->setChild(0,0,new QStandardItem("2309291")); model->item(1, 0)->setChild(0,1,new QStandardItem("小曾")); model->item(1, 0)->setChild(0,2,new QStandardItem("老曾")); // 第二行 model->item(1, 0)->setChild(1,0,new QStandardItem("2307266")); model->item(1, 0)->setChild(1, 1,new QStandardItem("小郑")); model->item(1, 0)->setChild(1,2,new QStandardItem("老郑")); // 顶层节点3 model->setItem(2, new QStandardItem("神童班")); // 第一行 model->item(2, 0)->setChild(0,0,new QStandardItem("23061685")); model->item(2, 0)->setChild(0,1, new QStandardItem("小季")); model->item(2, 0)->setChild(0, 2,new QStandardItem("扯牛堂认证医师老季")); // 第二行 model->item(2, 0)->setChild(1,0,new QStandardItem("23064217")); model->item(2, 0)->setChild(1,1,new QStandardItem("小陆")); model->item(2, 0)->setChild(1,2,new QStandardItem("老陆")); // 第三行 model->item(2, 0)->setChild(2,0, new QStandardItem("23031982")); model->item(2, 0)->setChild(2,1,new QStandardItem("小严")); model->item(2, 0)->setChild(2,2,new QStandardItem("严嵩第11代孙")); // 设置列标题 model->setHorizontalHeaderLabels({"学号", "姓名", "家长代表"}); // 把模型设置到视图 view->setModel(model); view->setWindowTitle("厚黑幼儿园"); // 显示视图 view->show(); return QApplication::exec(); }
虽然在列表模型中，每个 QStandardItem 都可以把整个二维表作为子节点，而且任意行、列处的项都可以拥有子节点。但是，QTreeView 视图只允许第一列出现折叠效果，所以，对于可折叠的父节点，咱们用一列就可以了，就算设置了多列也没有效果的。不妨想一下，如果每个单元格都可以折叠，那么不仅这控件设计起来困难，而看起来也很混乱，用户没法用了。所以，QTreeView 只认第一列可以折叠。
model 的 setHorizontalHeaderLabels 方法用来设置水平方向上的标题，参数是一个字符串列表。水平方向就是列标题；如果是行标题，就是垂直方向，要调用 setVerticalHeaderLabels 方法。不过，行标题一般不怎么用，顶多显示行号。
最终显示的效果如下：
这个可以显示多列的 TreeView 真的很不错，可惜 .NET 中的 WinForms 和 WPF 自带控件 TreeView 没有这个玩法。