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

東邪獨孤發表於2023-09-29
QT模型

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

 

相關文章