C++ Qt開發：QItemDelegate自定義代理組件

来源:https://www.cnblogs.com/LyShark/archive/2023/12/20/17913733.html
-Advertisement-
Play Games

Qt 是一個跨平臺C++圖形界面開發庫，利用Qt可以快速開發跨平臺窗體應用程式，在Qt中我們可以通過拖拽的方式將不同組件放到指定的位置，實現圖形化開發極大的方便了開發效率，本章將重點介紹`QStyledItemDelegate`自定義代理組件的常用方法及靈活運用。在Qt中，`QStyledItemD... ...


Qt 是一個跨平臺C++圖形界面開發庫，利用Qt可以快速開發跨平臺窗體應用程式，在Qt中我們可以通過拖拽的方式將不同組件放到指定的位置，實現圖形化開發極大的方便了開發效率，本章將重點介紹QStyledItemDelegate自定義代理組件的常用方法及靈活運用。

在Qt中，QStyledItemDelegate 類是用於創建自定義表格視圖（如QTableView和QTableWidget）的委托類，允許你自定義表格中每個單元格的外觀和交互。QStyledItemDelegate 是QItemDelegate 的子類，提供了更現代、更易用的介面。此處我們將實現對QTableView表格組件的自定義代理功能，例如預設情況下表格中的預設代理就是一個編輯框，我們只能夠在編輯框內輸入數據，而有時我們想選擇數據而不是輸入，此時就需要重寫編輯框實現選擇的效果，代理組件常用於個性化定製表格中的欄位類型。

1.1 概述代理類

代理類的作用是用來實現組件重寫的，例如TableView中預設是可編輯的，之所以可編輯是因為Qt預設為我們重寫了QLineEdit編輯框實現的，也可理解為將組件嵌入到了表格中，實現了對錶格的編輯功能。

在自定義代理中QAbstractItemDelegate是所有代理類的抽象基類，它用於創建自定義的項委托。提供了一個基本的框架，使得可以定製如何在視圖中繪製和編輯數據項。

QAbstractItemDelegate 是 QItemDelegate 的基類，而 QItemDelegate 則是 QStyledItemDelegate 的基類。這個繼承體系提供了不同層次的定製能力。我們繼承任何組件時都必須要包括如下4個函數：

  • CreateEditor() 用於創建編輯模型數據的組件，例如(QSpinBox組件)
  • SetEditorData() 從數據模型獲取數據，以供Widget組件進行編輯
  • SetModelData() 將Widget組件上的數據更新到數據模型
  • UpdateEditorGeometry() 給Widget組件設置一個合適的大小

通過繼承 QAbstractItemDelegate 並實現這些函數，讀者可創建一個定製的項委托，用於控制數據項在視圖中的外觀和交互行為。此處我們分別重寫三個代理介面，其中兩個ComBox組件用於選擇婚否，而第三個SpinBox組件則用於調節數值範圍，先來定義三個重寫部件。

1.2 自定義代理組件

這裡我們以第一個SpinBox組件為例，要實現代理該組件，首先需要在項目上新建一個SpinDelegate類，並依次實現上述的四個方法，先來開創建流程；

  • 選擇addnew選中 C++ Class 輸入自定義類名稱QWintSpinDelegate，然後基類繼承QStyledItemDelegate/QMainWindow，然後下一步結束嚮導，同理其他功能的創建也如此。

接著就是對該介面的重寫了，此處重寫代碼spindelegate.cpp如下所示，其關鍵位置的解釋可參考註釋部分。

#include "spindelegate.h"
#include <QSpinBox>

QWIntSpinDelegate::QWIntSpinDelegate(QObject *parent):QStyledItemDelegate(parent)
{
}

// 創建代理編輯組件
QWidget *QWIntSpinDelegate::createEditor(QWidget *parent,const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    Q_UNUSED(option);
    Q_UNUSED(index);

    QSpinBox *editor = new QSpinBox(parent);  // 創建一個QSpinBox
    editor->setFrame(false);                  // 設置為無邊框
    editor->setMinimum(0);
    editor->setMaximum(10000);
    return editor;                            // 返回此編輯器
}

// 從數據模型獲取數據，顯示到代理組件中
void QWIntSpinDelegate::setEditorData(QWidget *editor,const QModelIndex &index) const
{
    // 獲取數據模型的模型索引指向的單元的數據
    int value = index.model()->data(index, Qt::EditRole).toInt();

    QSpinBox *spinBox = static_cast<QSpinBox*>(editor);   // 強制類型轉換
    spinBox->setValue(value);                             // 設置編輯器的數值
}

// 將代理組件的數據，保存到數據模型中
void QWIntSpinDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
{
    QSpinBox *spinBox = static_cast<QSpinBox*>(editor); // 強制類型轉換
    spinBox->interpretText();                           // 解釋數據，如果數據被修改後，就觸發信號
    int value = spinBox->value();                       // 獲取spinBox的值
    model->setData(index, value, Qt::EditRole);         // 更新到數據模型
}

// 設置組件大小
void QWIntSpinDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    Q_UNUSED(index);
    editor->setGeometry(option.rect);
}

接著重寫介面floatspindelegate.cpp實現代碼如上述部分一致，唯一的變化是組件變了，代碼如下；

#include "floatspindelegate.h"
#include <QDoubleSpinBox>

QWFloatSpinDelegate::QWFloatSpinDelegate(QObject *parent):QStyledItemDelegate(parent)
{
}

QWidget *QWFloatSpinDelegate::createEditor(QWidget *parent,
   const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    Q_UNUSED(option);
    Q_UNUSED(index);

    QDoubleSpinBox *editor = new QDoubleSpinBox(parent);
    editor->setFrame(false);
    editor->setMinimum(0);
    editor->setDecimals(2);
    editor->setMaximum(10000);

    return editor;
}

void QWFloatSpinDelegate::setEditorData(QWidget *editor,
                      const QModelIndex &index) const
{
    float value = index.model()->data(index, Qt::EditRole).toFloat();
    QDoubleSpinBox *spinBox = static_cast<QDoubleSpinBox*>(editor);
    spinBox->setValue(value);
}

void QWFloatSpinDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
{
    QDoubleSpinBox *spinBox = static_cast<QDoubleSpinBox*>(editor);
    spinBox->interpretText();
    float value = spinBox->value();
    QString str=QString::asprintf("%.2f",value);

    model->setData(index, str, Qt::EditRole);
}

void QWFloatSpinDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    editor->setGeometry(option.rect);
}

最後重寫介面comboxdelegate.cpp其代碼如下所示；

#include "comboxdelegate.h"
#include <QComboBox>

QWComboBoxDelegate::QWComboBoxDelegate(QObject *parent):QItemDelegate(parent)
{

}

QWidget *QWComboBoxDelegate::createEditor(QWidget *parent,const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    QComboBox *editor = new QComboBox(parent);

    editor->addItem("已婚");
    editor->addItem("未婚");
    editor->addItem("單身");

    return editor;
}

void QWComboBoxDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const
{
    QString str = index.model()->data(index, Qt::EditRole).toString();

    QComboBox *comboBox = static_cast<QComboBox*>(editor);
    comboBox->setCurrentText(str);
}

void QWComboBoxDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
{
    QComboBox *comboBox = static_cast<QComboBox*>(editor);
    QString str = comboBox->currentText();
    model->setData(index, str, Qt::EditRole);
}

void QWComboBoxDelegate::updateEditorGeometry(QWidget *editor,const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    editor->setGeometry(option.rect);
}

將部件導入到mainwindow.cpp主程式中，並將其通過ui->tableView->setItemDelegateForColumn(0,&intSpinDelegate);關聯部件到指定的table下標索引上面。

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

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

    // 初始化模型數據
    model = new QStandardItemModel(4,6,this);      // 初始化4行,每行六列
    selection = new QItemSelectionModel(model);    // 關聯模型

    ui->tableView->setModel(model);
    ui->tableView->setSelectionModel(selection);

    // 添加表頭
    QStringList HeaderList;
    HeaderList << "序號" << "姓名" << "年齡" << "性別" << "婚否" << "薪資";
    model->setHorizontalHeaderLabels(HeaderList);

    // 批量添加數據
    QStringList DataList[3];
    QStandardItem *Item;

    DataList[0] << "1001" << "admin" << "24" << "男" << "已婚" << "4235.43";
    DataList[1] << "1002" << "guest" << "23" << "男" << "未婚" << "20000.21";
    DataList[2] << "1003" << "lucy" << "37" << "女" << "單身" << "8900.23";

    int Array_Length = DataList->length();                          // 獲取每個數組中元素數
    int Array_Count = sizeof(DataList) / sizeof(DataList[0]);       // 獲取數組個數

    for(int x=0; x<Array_Count; x++)
    {
        for(int y=0; y<Array_Length; y++)
        {
            // std::cout << DataList[x][y].toStdString().data() << std::endl;
            Item = new QStandardItem(DataList[x][y]);
            model->setItem(x,y,Item);
        }
    }

    // 為各列設置自定義代理組件
    // 0，4，5 代表第幾列 後面的函數則是使用哪個代理類的意思
    ui->tableView->setItemDelegateForColumn(0,&intSpinDelegate);
    ui->tableView->setItemDelegateForColumn(4,&comboBoxDelegate);
    ui->tableView->setItemDelegateForColumn(5,&floatSpinDelegate);
}

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

運行後，序號部分與薪資部分將變成一個SpinBox組件，讀者可自行調節大小，如下圖；

而婚否欄位將被重寫成一個ComBoBox組件，這有助於讓用戶直接選擇一個狀態，如下圖；

完整案例下載

文章出處：https://www.cnblogs.com/LyShark/p/17913733.html
本博客所有文章除特別聲明外，均採用 BY-NC-SA 許可協議。轉載請註明出處！
您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • Redis全文搜索教程之創建索引並關聯源數據
    Redis 全文搜索是依賴於 Redis 官方提供的 RediSearch 來實現的。RediSearch 提供了一種簡單快速的方法對 hash 或者 json 類型數據的任何欄位建立二級索引，然後就可以對被索引的 hash 或者 json 類型數據欄位進行搜索和聚合操作。 這裡我們把被索引的 ha ...
  • C++系列三：QT代碼庫
    目錄前言QT小記1. 菜單欄、工具欄、狀態欄2. 自定義的對話框3. 任務管理器4. 鏈接資料庫mysql，sqlite5. Widgets Gallery Example 代碼學習：999.ControlsQT-For-Python1. DemoQT-Quick1. HelloWorld2. 簡單 ...
  • AVL樹和紅黑樹的Python代碼實現
    AVL樹 AVL樹是一種自平衡二叉搜索樹。在這種樹中，任何節點的兩個子樹的高度差被嚴格控制在1以內。這確保了樹的平衡，從而保證了搜索、插入和刪除操作的高效性。AVL樹是由Georgy Adelson-Velsky和Evgenii Landis在1962年發明的，因此得名（Adelson-Velsky ...
  • C++ Qt開發：TabWidget實現多窗體功能
    Qt 是一個跨平臺C++圖形界面開發庫，利用Qt可以快速開發跨平臺窗體應用程式，在Qt中我們可以通過拖拽的方式將不同組件放到指定的位置，實現圖形化開發極大的方便了開發效率，本章將重點介紹`TabWidget`標簽組件的常用方法及靈活運用。`QTabWidget` 是Qt中用於實現標簽頁（tabbed... ...
  • 01Java語言概述
    JavaSE學習思維導圖 目錄1 Java語言概述1.1 Java 概述1.2 Java 語言簡史1.3 Java 之父1.4 Java 技術體系平臺2 Java 開發環境搭建2.1 JDK JRE2.2 JDK版本的選擇2.3 JDK 的下載2.4 JDK 的安裝2.5 配置path環境變數2.5 ...
  • 玩轉Spring狀態機
    本文主要介紹了設計模式中的狀態模式，併在此基礎上介紹了Spring狀態機相關的概念，並根據常見的訂單流轉場景，介紹了Spring狀態機的使用方式。文中如有不當之處，歡迎在評論區批評指正。 ...
  • 【Python微信機器人】第六篇：優化使用方式，可pip安裝
    優化內容 這篇不聊技術點，說一下優化後的Python機器人代碼怎麼使用，優化內容如下： 將hook庫獨立成一個庫，發佈到pypi，可使用pip安裝 將微信相關的代碼發佈成另一個庫，也可以pip安裝 git倉庫統一，以後都在這個倉庫更新，不再一篇文章一個倉庫 開始建群，根據群里反饋增加功能和修複bug ...
  • 【scikit-learn基礎】--『預處理』之 分類編碼
    數據的預處理是數據分析，或者機器學習訓練前的重要步驟。通過數據預處理，可以 提高數據質量，處理數據的缺失值、異常值和重覆值等問題，增加數據的準確性和可靠性 整合不同數據，數據的來源和結構可能多種多樣，分析和訓練前要整合成一個數據集 提高數據性能，對數據的值進行變換，規約等（比如無量綱化），讓演算法更加 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類