【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 没有这个玩法。