C/C++ Qt TreeWidget 單層樹形組件應用

• 2021 年 11 月 26 日
• 筆記
• C/C++ Qt 圖形化開發

TreeWidget 目錄樹組件，該組件適用於創建和管理目錄樹結構，在開發中我們經常會把它當作一個升級版的ListView組件使用，因為ListView每次只能顯示一列數據集，而使用TableWidget組件顯示多列顯得不夠美觀，此時使用Tree組件顯示單層結構是最理想的方式，本章博文將通過TreeWidget實現多欄位顯示，並增加一個自定義菜單，通過在指定記錄上右鍵可彈出該菜單並對指定記錄進行操作。

1.通過TreeView組件實現一個只讀屬性的樹形目錄，該目錄中指定三個欄位，分別用來表示ID,IP地址,用戶名欄位.

初始化Tree組件

• 1.初始化並設置treeView屬性
• 2.設置列頭長度
• 3.設置列頭數據
• 4.設置表中元素

#include <QSplitter>
#include <QTreeView>
#include <QTextCodec>
#include <QStandardItemModel>

// By: LyShark
// //www.cnblogs.com/lyshark
MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent),ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    QStandardItemModel *tree = new QStandardItemModel(0,3,this);

    // 設置treeView屬性
    ui->treeView->setColumnWidth(0,300);                               // 設置最後一列寬度自適應
    ui->treeView->setIndentation(1);                                   // 設置表頭縮進為1
    ui->treeView->setEditTriggers(QAbstractItemView::NoEditTriggers);  // 節點不可編輯

    // 設置列頭長度
    ui->treeView->setColumnWidth(0,50);      // 設置第1列長度
    ui->treeView->setColumnWidth(1,200);     // 設置第2列長度
    ui->treeView->setColumnWidth(2,200);     // 設置第3列長度

    // 設置列頭數據
    tree->setHeaderData(0, Qt::Horizontal, tr("ID"));
    tree->setHeaderData(1, Qt::Horizontal, tr("IP地址"));
    tree->setHeaderData(2, Qt::Horizontal, tr("用戶"));

    ui->treeView->setModel(tree);           // 將表頭設置到模型

    // 設置表中元素
    QList<QStandardItem *> ptr;

    QStandardItem *item_uid = new QStandardItem("1001");
    item_uid->setIcon(QIcon(":/image/1.ico"));
    ptr.push_back(item_uid);

    QStandardItem *item_addr = new QStandardItem("192.168.1.1");
    ptr.push_back(item_addr);

    QStandardItem *item_username = new QStandardItem("lyshark");
    ptr.push_back(item_username);
    tree->appendRow(ptr);
}

程式碼運行後，如下所示：

2.使用TreeWidget組件，自己定義一個菜單，並將該菜單綁定到Tree組件內，具體實現程式碼如下。

#include "mainwindow.h"
#include "ui_mainwindow.h"

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 在MainWindow中使用右擊菜單需要添加此項
    ui->treeWidget->setContextMenuPolicy(Qt::CustomContextMenu);

    // 創建基礎頂部菜單
    QMenuBar *bar = menuBar();
    this->setMenuBar(bar);
    QMenu * fileMenu = bar->addMenu("菜單1");

    // 實現只隱藏菜單1其他的不受影響
    fileMenu->menuAction()->setVisible(false);

    // 添加子菜單
    GetColumnAction = fileMenu->addAction("獲取列號");
    GetRowDataAction = fileMenu->addAction("獲取本行數據");
    GetLineAction = fileMenu->addAction("獲取行號");

    // 分別設置圖標
    GetColumnAction->setIcon(QIcon(":/image/1.ico"));
    GetRowDataAction->setIcon(QIcon(":/image/2.ico"));
    GetLineAction->setIcon(QIcon(":/image/3.ico"));

    // 為子菜單綁定熱鍵
    GetColumnAction->setShortcut(Qt::CTRL | Qt::Key_A);
    GetRowDataAction->setShortcut(Qt::SHIFT | Qt::Key_S);
    GetLineAction->setShortcut(Qt::CTRL | Qt::SHIFT | Qt::Key_B);

    // 設置treeWidget屬性
    ui->treeWidget->setColumnCount(4);         // 設置總列數
    ui->treeWidget->setColumnWidth(0,300);     // 設置最後一列寬度自適應
    ui->treeWidget->setIndentation(1);         // 設置表頭縮進為1

    // 設置表頭數據
    QStringList headers;
    headers.append("文件名");
    headers.append("更新時間");
    headers.append("文件類型");
    headers.append("文件大小");
    ui->treeWidget->setHeaderLabels(headers);

    // 模擬插入數據到表中
    for(int x=0;x<100;x++)
    {
        QTreeWidgetItem* item=new QTreeWidgetItem();
        item->setText(0,"<lyshark.com>");
        item->setIcon(0,QIcon(":/image/1.ico"));
        item->setText(1,"2020-12-11");
        item->setText(2,"*.pdf");
        item->setText(3,"102MB");
        item->setIcon(3,QIcon(":/image/2.ico"));
        ui->treeWidget->addTopLevelItem(item);
    }
}

MainWindow::~MainWindow()
{
    delete ui;
}

// 當treeWidget中的右鍵被點擊時則觸發
// By: LyShark
// //www.cnblogs.com/lyshark
void MainWindow::on_treeWidget_customContextMenuRequested(const QPoint &pos)
{
    Q_UNUSED(pos);

    // 新建Menu菜單
    QMenu *ptr = new QMenu(this);

    // 添加Actions創建菜單項
    ptr->addAction(GetColumnAction);
    ptr->addAction(GetLineAction);

    // 添加一個分割線
    ptr->addSeparator();
    ptr->addAction(GetRowDataAction);

    // 在滑鼠游標位置顯示右鍵快捷菜單
    ptr->exec(QCursor::pos());
    // 手工創建的指針必須手工刪除
    delete ptr;
}

最終我們實現的效果是以下效果。