【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 沒有這個玩法。