C++ Qt開發：SqlTableModel映射組件應用

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

Qt 是一個跨平臺C++圖形界面開發庫，利用Qt可以快速開發跨平臺窗體應用程式，在Qt中我們可以通過拖拽的方式將不同組件放到指定的位置，實現圖形化開發極大的方便了開發效率，本章將重點介紹`SqlTableModule`組件的常用方法及靈活運用。在多數情況下我們需要使用SQL的方法來維護資料庫，但此方... ...


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

在多數情況下我們需要使用SQL的方法來維護資料庫，但此方式相對較為繁瑣對於表格等數據的編輯非常不友好，在Qt中提供了QSqlTableModel模型類，它為開發者提供了一種直觀的方式來與資料庫表格進行交互。通過使用該組件可以將資料庫與特定的組件進行關聯，一旦關聯被建立那麼用戶的所有操作均可以使用函數的方式而無需使用SQL語句，該特性有點類似於ORM對象關係映射機制。

在接下來的章節中，我們將學習如何配置 QSqlTableModel、與資料庫進行交互、實現數據的動態顯示和編輯，首先讀者應繪製好UI界面，本次案例界面稍顯複雜，讀者可自行完成如下案例的繪製；

以下是 QSqlTableModel 類的一些常用方法，包括方法名、參數以及簡要說明。這裡列舉的方法並非全部，而是一些常見的方法，更詳細的信息可以參考官方文檔。

方法 描述
QSqlTableModel(QObject *parent = nullptr, QSqlDatabase db = QSqlDatabase()) 構造函數，創建 QSqlTableModel 對象。
setTable(const QString &tableName) 設置要操作的資料庫表名。
select() 執行查詢操作，從資料庫中獲取數據。
rowCount(const QModelIndex &parent = QModelIndex()) const 返回模型中的行數。
columnCount(const QModelIndex &parent = QModelIndex()) const 返回模型中的列數。
record(int row) 返回指定行的記錄。
setFilter(const QString &filter) 設置用於過濾數據的條件。
setSort(int column, Qt::SortOrder order) 設置排序的列和排序規則。
setEditStrategy(QSqlTableModel::EditStrategy strategy) 設置編輯策略，決定何時將修改提交到資料庫。
setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) 設置模型中指定索引的數據。
data(const QModelIndex &index, int role = Qt::DisplayRole) const 返回模型中指定索引的數據。
addRecord(const QSqlRecord &values) 添加一條記錄到模型中。
removeRow(int row) 從模型中刪除指定行。
insertRecord(int row, const QSqlRecord &record) 在指定位置插入一條記錄。
submitAll() 提交所有對模型的修改到資料庫。
revertAll() 撤銷對模型的所有修改。
setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole) 設置表頭數據。
indexInQuery(const QSqlQuery &query) const 返回查詢中模型的索引。

這些方法提供了對 QSqlTableModel 進行數據操作、過濾、排序以及提交修改的基本手段。通過這些方法，可以在應用程式中方便地操作資料庫表格的數據。

1.1 初始化組件

首先我們來看一下MainWindow初始化部分是如何工作的，主要實現了以下功能：

打開資料庫

首先使用SQLite資料庫驅動連接名為"database.db"的資料庫文件。如果資料庫連接失敗，函數直接返回。接著通過新建一個QSqlTableModel類，並調用setTable來打開一個數據表，設置編輯策略為 OnManualSubmit，即手動提交修改。並通過setSort函數來設置排序方式為根據ID欄位升序Qt::AscendingOrder排列。

DB = QSqlDatabase::addDatabase("QSQLITE");
DB.setDatabaseName("./database.db");
if (!DB.open())
{
    return;
}

tabModel = new QSqlTableModel(this, DB);
tabModel->setTable("Student");
tabModel->setEditStrategy(QSqlTableModel::OnManualSubmit);
tabModel->setSort(tabModel->fieldIndex("id"), Qt::AscendingOrder);
if (!(tabModel->select()))
{
    return;
}

設置欄位名稱

此處我們資料庫中有6個欄位，也就需要設置資料庫欄位與表格關聯，如下則是對欄位的動態關聯。

tabModel->setHeaderData(tabModel->fieldIndex("id"),Qt::Horizontal,"Uid");
tabModel->setHeaderData(tabModel->fieldIndex("name"),Qt::Horizontal,"Uname");
tabModel->setHeaderData(tabModel->fieldIndex("sex"),Qt::Horizontal,"Usex");
tabModel->setHeaderData(tabModel->fieldIndex("age"),Qt::Horizontal,"Uage");
tabModel->setHeaderData(tabModel->fieldIndex("mobile"),Qt::Horizontal,"Umobile");
tabModel->setHeaderData(tabModel->fieldIndex("city"),Qt::Horizontal,"Ucity");

關聯選擇模型和數據模型

通過創建 QItemSelectionModel 對象 theSelection 並關聯到 tabModel模型，將數據模型和選擇模型關聯到 ui->tableView，並設置選擇模式為行選擇模式。

theSelection = new QItemSelectionModel(tabModel);
ui->tableView->setModel(tabModel);
ui->tableView->setSelectionModel(theSelection);
ui->tableView->setSelectionBehavior(QAbstractItemView::SelectRows);

創建數據映射

創建 QDataWidgetMapper 對象 dataMapper，將數據模型設置為 tabModel，設置提交策略為 AutoSubmit，即自動提交修改。並將 "name" 欄位映射到 ui->lineEdit_name，預設選中第一條映射記錄。

dataMapper = new QDataWidgetMapper();
dataMapper->setModel(tabModel);
dataMapper->setSubmitPolicy(QDataWidgetMapper::AutoSubmit);
dataMapper->addMapping(ui->lineEdit_name, tabModel->fieldIndex("name"));
dataMapper->toFirst();

信號和槽連接

當選擇模型中的當前行改變時，連接到槽函數 on_currentRowChanged，用於在右側編輯框中輸出當前選擇的記錄。

connect(theSelection, SIGNAL(currentRowChanged(QModelIndex, QModelIndex)), this, SLOT(on_currentRowChanged(QModelIndex, QModelIndex)));

這個槽函數的實現如下所示，當行被點擊後執行獲取name/mobile欄位，並放入映射數據集中的lineEdit編輯框中，使其能夠動態的顯示數據列表。

void MainWindow::on_currentRowChanged(const QModelIndex &current, const QModelIndex &previous)
{
    Q_UNUSED(previous);

    dataMapper->setCurrentIndex(current.row());      // 更細數據映射的行號
    int curRecNo=current.row();                      // 獲取行號
    QSqlRecord  curRec=tabModel->record(curRecNo);   // 獲取當前記錄

    QString uname = curRec.value("name").toString();     // 取出數據
    QString mobile = curRec.value("mobile").toString();

    ui->lineEdit_name->setText(uname);                   // 設置到編輯框
    ui->lineEdit_mobile->setText(mobile);
}

最後在UI文件的底部有一個comboBox組件，我們通過動態的查詢記錄，並將其賦值為第一個欄位元素，其代碼如下所示；

QSqlRecord emptyRec=tabModel->record();           //獲取空記錄，只有欄位名
for (int i=0;i<emptyRec.count();i++)
{
    ui->comboBox->addItem(emptyRec.fieldName(i));
}

這段代碼實現了一個簡單的資料庫瀏覽和編輯界面，用戶可以通過表格展示的方式查看和編輯 "Student" 表格中的數據。當程式運行後則可以看到如下圖所示的初始化部分；

1.2 數據處理

1.2.1 新增一條記錄

當用戶按下on_pushButton_add_clicked按鈕時，則會在表格中新增一條記錄，並設置預設值的功能。下麵是代碼的詳細解釋：

插入新行

在表格模型 tabModel 的末尾插入一行新記錄。QModelIndex() 是一個空的索引，表示插入到末尾。

tabModel->insertRow(tabModel->rowCount(), QModelIndex());

獲取最後一行的索引

獲取剛剛插入的行的索引，這裡假設 "name" 欄位對應的列索引是 1。

QModelIndex curIndex = tabModel->index(tabModel->rowCount() - 1, 1);

清空選擇項並設置新行為當前選擇行

清空當前選擇項，然後將剛剛插入的行設為當前選擇行，並選擇該行。

theSelection->clearSelection();
theSelection->setCurrentIndex(curIndex, QItemSelectionModel::Select);

獲取當前行號

獲取當前行的行號。

int currow = curIndex.row();

設置自動生成的編號和預設值

這段代碼的作用是在表格模型中插入一行新記錄，然後設置該行的預設值，其中 "Uid" 欄位會自動生成一個編號，"Usex" 欄位預設為 "M"，"Uage" 欄位預設為 "0"。

  • 自動生成編號，假設 "Uid" 欄位對應的列索引是 0。
  • 將 "Usex" 欄位設置為 "M"。
  • 將 "Uage" 欄位設置為 "0"。
tabModel->setData(tabModel->index(currow, 0), 1000 + tabModel->rowCount());
tabModel->setData(tabModel->index(currow, 2), "M");
tabModel->setData(tabModel->index(currow, 3), "0");

運行代碼，讀者可自行點擊增加記錄按鈕，每次點擊均會在表格中提供新行，當讀者點擊on_pushButton_save_clicked保存按鈕是則會調用submitAll()該函數用於將數據提交到資料庫中存儲，如下圖所示；

1.2.4 插入一條記錄

在 TableView 中當前選擇行的上方插入一行新記錄，並自動生成編號。下麵是代碼的詳細解釋：

獲取當前選擇行的索引和行號

獲取當前選擇的單元格的索引和行號。

QModelIndex curIndex = ui->tableView->currentIndex();
int currow = curIndex.row();

在當前行上方插入一行新記錄

在表格模型 tabModel 的當前選擇行（curIndex.row()）的上方插入一行新記錄。QModelIndex() 是一個空的索引，表示插入到指定行的上方。

tabModel->insertRow(curIndex.row(), QModelIndex());

設置自動生成的編號

自動生成編號，假設 "Uid" 欄位對應的列索引是 0。

tabModel->setData(tabModel->index(currow, 0), 1000 + tabModel->rowCount());

清除已有選擇並將當前選擇行設為新插入的行

清空已有選擇項，然後將當前選擇行設為新插入的行，並選擇該行。

theSelection->clearSelection();
theSelection->setCurrentIndex(curIndex, QItemSelectionModel::Select);

當上述代碼運行後則可以實現在指定行的上方插入一行新紀錄，併為新插入的行生成一個自增的編號，其效果如下圖所示；

對於刪除一條記錄來說則可以通過調用tabModel->removeRow(curIndex.row())來實現刪除所選行，因為其實現起來很簡單此處就不再演示，具體實現細節可以參考附件。

1.2.5 修改表中記錄

如下所示代碼，用於批量修改表格中所有記錄的 "Uage" 欄位值為某個固定的年齡。下麵是代碼的詳細解釋：

檢查是否有記錄

如果表格中沒有記錄，則直接返回，不執行後續的批量修改操作。

if (tabModel->rowCount() == 0)
    return;

迴圈遍歷每一行記錄並修改年齡

首先使用 tabModel->record(i) 獲取表格模型中的第 i 行記錄，接著使用 ui->lineEdit->text() 獲取用戶在 QLineEdit 中輸入的文本，作為新的年齡值，並通過 aRec.setValue("age", ...) 設置 "age" 欄位的新值，最後使用 tabModel->setRecord(i, aRec) 將修改後的記錄設置回表格模型中的相應行。

for (int i = 0; i < tabModel->rowCount(); i++)
{
    QSqlRecord aRec = tabModel->record(i);                // 獲取當前記錄
    aRec.setValue("age", ui->lineEdit->text());           // 設置數據，使用 QLineEdit 中的文本作為新的年齡值
    tabModel->setRecord(i, aRec);                         // 將修改後的記錄設置回表格模型中的相應行
}

提交修改

使用 tabModel->submitAll() 提交對錶格模型的所有修改，將修改保存到資料庫中。

tabModel->submitAll();

上述代碼實現了一個簡單的批量修改操作，將表格中所有記錄的 "Uage" 欄位值設置為用戶在 QLineEdit 中輸入的年齡值。請註意，這裡沒有對輸入的年齡值進行驗證，確保輸入的是合法的數字。在實際應用中，可能需要添加一些輸入驗證和錯誤處理的邏輯。

1.2.6 表記錄的排序

升序與降序排列

對錶中記錄的排序可以使用模型提供的setSort函數來實現，通過對該欄位第二個參數設置為Qt::AscendingOrder則是升序排序，反之如果設置為Qt::DescendingOrder則為降序排序。

如下所示代碼用於根據用戶選擇的欄位對錶格進行排序，並重新執行查詢以更新表格數據。下麵是代碼的詳細解釋：

  • ui->comboBox->currentIndex() 獲取用戶在 QComboBox 中選擇的欄位的索引。
  • Qt::AscendingOrder 表示升序排序。
  • tabModel->select()執行對資料庫的查詢操作，重新獲取數據並應用排序。
// 升序排序
tabModel->setSort(ui->comboBox->currentIndex(), Qt::AscendingOrder);
// 降序排序
tabModel->setSort(ui->comboBox->currentIndex(),Qt::DescendingOrder);
// 刷新查詢
tabModel->select();

上述代碼的作用是根據用戶在下拉框中選擇的欄位進行升序或降序排序，並將排序後的結果重新載入到表格中。在使用這段代碼之前，用戶需要在 QComboBox 中選擇一個欄位，作為排序的依據。以升序排序為例，輸出效果如下圖所示；

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

-Advertisement-
Play Games
更多相關文章
  • 微信小程式引入和風天氣圖標庫
    npm導入和風天氣的圖標庫後使用沒有效果，就在網上查詢了下怎麼解決，然後動手嘗試一下。 參考文章 步驟 1. 下載圖標文件(鏈接)，解壓後大致這樣 2. 在transfonter網站將需要的圖標字體轉成Base64，在font\fonts文件下 選擇上傳 下載 3. 解壓後把stylesheet.c ...
  • keycloak~從login-status-iframe頁面總結如何跨域傳值~續
    keycloak~從login-status-iframe相關文章，可閱讀我的這兩篇keycloak~從login-status-iframe頁面總結如何跨域傳值 ,keycloak~對接login-status-iframe頁面判斷用戶狀態變更 。 什麼是跨域 跨域（Cross-Origin）是指 ...
  • Python筆記一之excel的讀取
    本文首發於公眾號：Hunter後端 原文鏈接：Python筆記一之excel的讀取 這裡我常用的 python 對於 excel 的讀取庫有兩個，一個是 xlsxwriter 用於操作 excel 的寫入，一個是 xlrd 用於 excel 文件的讀取。 使用的庫的版本如下： xlsx==1.2.6 ...
  • Spring Boot學習隨筆- Jasypt加密資料庫用戶名和密碼以及解密
    第十九章介紹了Jasypt，用於在Spring Boot應用中加密敏感信息。通過jasypt-spring-boot-starter依賴項，配置加密演算法和密碼，並使用StringEncryptor加密和解密。加密後的信息可嵌入屬性文件中，提高資料庫密碼等敏感信息的安全性。加解密基於密鑰，建議將密鑰通... ...
  • 【Python】【OpenCV】定位二維碼
    相較於BarCode，QRCode有明顯的特征區域，也就是左上角、右上角、左下角三個”回“字區域，得益於hierarchy中，父子關係的輪廓是連續的（下標），所以這個時候我們就可以通過cv2.findContours()返回的hierarchy來進行定位。 我們直接上代碼 1 import cv2 ...
  • auto{x}與auto(x)---一位中國小伙為cppreference作出的貢獻
    C++作為一門靜態類型語言，是需要程式員聲明變數類型的。然而來到了C++11，auto的誕生使得變數聲明變得及為方便，尤其是對於比較長的模板類型，auto一定程度上為代碼編寫者減輕了負擔。到了C++23，突然來了個新特性：auto{x}/auto(x)，這又是個什麼東西，它的motivation又是 ...
  • Go 泛型之泛型約束
    Go 泛型之泛型約束 目錄Go 泛型之泛型約束一、引入二、最寬鬆的約束：any三、支持比較操作的內置約束：comparable四、自定義約束五、類型集合（type set）六、簡化版的約束形式七、約束的類型推斷八、小結 一、引入 雖然泛型是開發人員表達“通用代碼”的一種重要方式，但這並不意味著所有泛 ...
  • Scipy快速入門
    Scipy快速入門 註意事項 圖床在國外，配合美區、日區網路使用更佳，如遇圖片載入不出來，考慮換個VPN吧。 監修中敬告 本文處於Preview階段，不對文章內容負任何責任，如有意見探討歡迎留言。 聯繫方式——綠泡泡：NeoNexusX 常量 稀疏矩陣 （scipy.sparse） CSC 壓縮稀疏 ...
一周排行
    -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.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類