Qt底子 | QSqlTableModel 的使用

---

Qt SQL模块：

• Qt底子 | Qt SQL模块先容 | Qt SQL模块常用类及其常用函数先容
  
• Qt底子 | QSqlTableModel 的使用
  
• Qt底子 | QSqlQueryModel 的使用 | QSqlQuery的使用
  
• Qt底子 | QSqIRelationalTableModel 的使用
  

---

   关于 QSqlTableModel 、QSqlDatabase 、QDataWidgetMapper 类的使用可参考：Qt底子 | Qt SQL模块先容 | Qt SQL模块常用类及其常用函数先容
  一、QSqlTableModel 的使用

  这一部分使用 QSqlTableModel 表实际例数据库 demodb 中 employee 数据表的内容，实现编辑、插入、删除记录的操作，实现数据的排序和记录过滤，还实现 BLOB 范例字段 Photo 中存储照片的表现、导入等操作。
1.主窗口MainWindow类界说

1. #ifndef MAINWINDOW_H
2. #define MAINWINDOW_H
4. #include    <QMainWindow>
6. #include    <QLabel>
7. #include    <QString>
9. #include    <QtSql>
10. #include    <QDataWidgetMapper>
12. #include    "qwcomboboxdelegate.h"
15. namespace Ui {
16. class MainWindow;
17. }
19. class MainWindow : public QMainWindow
20. {
21.     Q_OBJECT
23. private:
24.     QSqlDatabase  DB;//数据库连接
25.     QSqlTableModel  *tabModel;  //数据模型
26.     QItemSelectionModel *theSelection; //选择模型
27.     QDataWidgetMapper   *dataMapper; //数据映射
28.     QWComboBoxDelegate   delegateSex; //自定义数据代理，性别
29.     QWComboBoxDelegate   delegateDepart; //自定义数据代理，部门
31.     void    openTable();//打开数据表
32.     void    getFieldNames();//获取字段名称,填充“排序字段”的comboBox
33. public:
34.     explicit MainWindow(QWidget *parent = 0);
35.     ~MainWindow();
37. private slots:
38.     void on_currentChanged(const QModelIndex &current, const QModelIndex &previous);
39.         // QTableView的SelectionModel的行发生了变化，进行处理
40.     void on_currentRowChanged(const QModelIndex &current, const QModelIndex &previous);
42.     void on_actOpenDB_triggered();
43.     void on_actRecAppend_triggered();
44.     void on_actRecInsert_triggered();
45.     void on_actRevert_triggered();
46.     void on_actSubmit_triggered();
47.     void on_actRecDelete_triggered();
48.     void on_actPhoto_triggered();
49.     void on_actPhotoClear_triggered();
50.     void on_radioBtnAscend_clicked();
51.     void on_radioBtnDescend_clicked();
52.     void on_radioBtnMan_clicked();
53.     void on_radioBtnWoman_clicked();
54.     void on_radioBtnBoth_clicked();
55.     void on_comboFields_currentIndexChanged(int index);
56.     void on_actScan_triggered();
57. private:
58.     Ui::MainWindow *ui;
59. };
61. #endif // MAINWINDOW_H

复制代码

MainWindow 类中界说了几个私有变量：

• QSqlDatabase DB：用于加载数据库驱动和建立与数据库之间的连接
  
• QSqlTableModel *tabModel：用于指定某个数据表 ，作为数据表的数据模型
  
• QItemSelectionModel *theSelection：作为 tabModel 的选择模型，提供 currentChanged()、currentRowChanged()信号，在 tabModel 选择的字段发生厘革、当前记录发生厘革时发射信号，以便步调举行响应。
  例如，在 currentChanged() 信号发射时，检查 tabModel 是否有数据被修改 ，从而更新界面上 “生存”和“取消“两个按钮的使能状态
  
• QDataWidgetMapper *dataMapper：用于实现界面组件与 tabModel 的字段之间的映射。
  例如，界面上的 QLineEdit 型的 dbEditName 组件与数据表的 Name 字段映射，当前记录厘革时会自动更新表现当前记录 Name 段的数据。
  
• QWComboBoxDelegate delegateSex：是自界说的基于 QComboBox 的代理类，delegateSex 和 delegateDepart 用作 tableView 中“性别” 和 “部分” 字段的代理组件。
  

私有函数：

• openTable函数：用于打开数据表，包罗添加 SQLite 数据库驱动、打开数据库文件、连接 employee 数据表并设置表现属性，并创建 tableView 表现的代理组件，设置数据源与界面组件的映射等
  
• getFieldNames函数：用于获取数据表 employee 的所有字段的名称，并添补界面上 “排序字段” 后的 ComboBox 组件。
  

槽函数：

• on_currentChanged：用于检查数据表内容是否修改，根据是否有未提交的修改，更新工具栏按钮 “生存” 和 “取消” 两个按钮的使能状态。
  
• on_currentRowChanged：用于在当前行厘革时，从新的记录里提取 Photo 字段的内容，并将图片在 QLabel 组件里表现出来。
  

2.构造函数

  MainWindow 的构造函数代码如下，重要是对 tableView 一些表现属性的设置。

1. MainWindow::MainWindow(QWidget *parent) :
2.     QMainWindow(parent),
3.     ui(new Ui::MainWindow)
4. {
5.     ui->setupUi(this);
7.     this->setCentralWidget(ui->splitter);
9. //   tableView显示属性设置
10.     ui->tableView->setSelectionBehavior(QAbstractItemView::SelectItems);
11.     ui->tableView->setSelectionMode(QAbstractItemView::SingleSelection);
12.     ui->tableView->setAlternatingRowColors(true);
13. //    ui->tableView->resizeColumnsToContents();
14. //    ui->tableView->horizontalHeader()->setStretchLastSection(true);
15. }

复制代码

• setSelectionBehavior函数：用于界说视图(View)选择哪种选择行为
  
  1. void setSelectionBehavior(QAbstractItemView::SelectionBehavior behavior)

  复制代码
  QAbstractItemView::SelectionBehavior是一个枚举范例，有如下选择：
  
  
  
  • QAbstractItemView::SelectItems：选择单个项
    
  • QAbstractItemView::SelectRows：仅选择行
    
  • QAbstractItemView::SelectColumns：仅选择列
    
  
  
• setSelectionMode函数：用于界说视图（view）的选择模式
  
  1. void setSelectionMode(QAbstractItemView::SelectionMode mode)

  复制代码
  QAbstractItemView::SelectionMode是一个枚举范例，有如下取值：
  
  
  
  • QAbstractItemView::SingleSelection：单选模式，用户只能选择一个项目。
    
  • QAbstractItemView::ContiguousSelection：连续选择模式，用户可以选择多个项目，但这些项目必须在视觉上是连续的。
    
  • QAbstractItemView::ExtendedSelection：扩展选择模式，用户可以选择多个项目，而且可以选择非连续的项目。
    
  • QAbstractItemView::MultiSelection：多选模式，用户可以选择多个项目。
    
  • QAbstractItemView::NoSelection：无选择模式
    
  
  
• setAlternatingRowColors函数：用来控制当前是否启用交替行颜色绘制背景
  
  1. void setAlternatingRowColors(bool enable)

  复制代码
  
  
  • 当 alternatingRowColors 属性设置为 true 时，视图中的项背景将使用 QPalette::Base 和 QPalette::AlternateBase 颜色交替绘制。QPalette::Base 是默认的背景颜色，而 QPalette::AlternateBase 是用于交替行的背景颜色。
    
    
    
    
  • 当 alternatingRowColors 属性设置为 false 时，所有项的背景将同一使用 QPalette::Base 颜色绘制。
    
  
  
• resizeColumnsToContents函数：用于根据列中每个项的代理组件的大小提示来调解所有列的宽度
  
  1. void QTableView::resizeColumnsToContents()

  复制代码
• horizontalHeader函数：用于返回 QTableView 的水平表头
  
  1. QHeaderView *QTableView::horizontalHeader() const

  复制代码

3.打开数据表

  打开数据表这一部分重要包罗：

• 添加 SQLite 数据库驱动、设置数据库名称、打开数据库
  
• 设置数据模型、选择模型、自界说代理组件、界面组件与模型数据字段间的数据映射
  

3.1 添加 SQLite 数据库驱动、设置数据库名称、打开数据库

  这一部分重要用到了 QSqlDatabase 类，该类用于处理与数据库的连接。

1. void MainWindow::on_actOpenDB_triggered()
2. {//打开数据表
3.     QString aFile=QFileDialog::getOpenFileName(this,"选择数据库文件","",
4.                              "SQL Lite数据库(*.db *.db3)");
5.     if (aFile.isEmpty())  //选择SQL Lite数据库文件
6.        return;
8. //打开数据库
9.     DB=QSqlDatabase::addDatabase("QSQLITE"); //添加 SQL LITE数据库驱动
10.     DB.setDatabaseName(aFile); //设置数据库名称
11. //    DB.setHostName();
12. //    DB.setUserName();
13. //    DB.setPassword();
14.     if (!DB.open())   //打开数据库
15.     {
16.         QMessageBox::warning(this, "错误", "打开数据库失败",
17.                                  QMessageBox::Ok,QMessageBox::NoButton);
18.         return;
19.     }
21. //打开数据表
22.     openTable();
23. }

复制代码

  补充：
  

• QSqlDatabase::addDatabase：该静态函数用于添加数据库驱动，其返回结果为 QSqlDatabase 类，该类可用于数据库操作，包罗建立数据库连接，设置登岸数据库的参数，打开数据库等。
  其完整的函数声明如下：
  
  1. [static] QSqlDatabase QSqlDatabase::addDatabase(const QString &type, const QString &connectionName = QLatin1String(defaultConnection))

  复制代码
  示例：
  
  1. // 添加一个名为 "myConnection" 的 SQLite 数据库连接
  2. QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE", "myConnection");
  3. db.setDatabaseName("example.db"); // 设置数据库文件名
  4. db.setUserName("user"); // 设置用户名
  5. db.setPassword("password"); // 设置密码
  7. // 打开数据库连接
  8. if (db.open()) {
  9.     QSqlQuery query;
  10.     query.exec("SELECT * FROM table_name"); // 执行查询
  11.     while (query.next()) {
  12.         // 处理查询结果
  13.     }
  14.     db.close();
  15. } else {
  16.     qDebug() << "Error: Unable to open database";
  17. }

  复制代码
  还有一个函数重载，参数指定的不是驱动名称，而是 QSqlDriver 类。
  
  1. [static] QSqlDatabase QSqlDatabase::addDatabase(QSqlDriver *driver, const QString &connectionName = QLatin1String(defaultConnection))

  复制代码
  示例：
  
  1. PGconn *con = PQconnectdb("host=server user=bart password=simpson dbname=springfield");
  2. QPSQLDriver *drv = new QPSQLDriver(con);
  3. QSqlDatabase db = QSqlDatabase::addDatabase(drv); // becomes the new default connection
  4. QSqlQuery query;
  5. query.exec("SELECT NAME, ID FROM STAFF");

  复制代码
• QSqlDatabase类的数据库连接操作：用于设置数据库连接与登岸参数
           留意：对于 SQLite 数据库，只需用 setDatabaseName() 设置数据库文件即可。如果是网络型数据库，如 Oracle、MS SQL Server等，还需要使用 setHostName() 设置主机名，setUserName() 设置数据库用户名，setPassword() 设置数据库登岸密码。
  
  
  
  • setDatabaseName：设置数据库名称
    
  • setHostName：设置数据库主机名
    
  • setUserName：设置数据库用户名
    
  • setPassword：设置数据库登岸密码
    
  
  
• open()函数：打开数据库。如果成功打开数据库则返回true
  

  3.2 数据模型设置、选择模型、自界说代理组件、界面组件与模型数据字段间的数据映射

  这部分用到 3 个类：

• QSqlTableModel：
  QSqlTableModel 是一个用于表现和编辑单个数据库表内容的模型
  
• QTableView：
  二维数据表视图组件，有多个行和多个列，每个基本表现单位是一个单位格，通过 setModel() 函数设置一个 QSqlTableModel 类的数据模型之后，一个单位格表现 QSqlTableModel 数据模型中的一个项
  
• QItemSelectionModel：
  一个用于跟踪视图组件的单位格选择状态的类，当在 QTableView 选择某个单位格，或多个单位格时，通过 QItemSelectionModel 可以获得选中的单位格的模型索引，为单位格的选择操作提供方便。
  

这几个类之间的关系是：QTableView是界面视图组件，其关联的数据模型是 QSqlTableModel，关联的项选择模型是 QItemSelectionModel。
数据模型创建与属性设置：

1. tabModel=new QSqlTableModel(this,DB);//数据表
3. tabModel->setTable("employee"); //设置数据表
4. tabModel->setEditStrategy(QSqlTableModel::OnManualSubmit);//数据保存方式，OnManualSubmit , OnRowChange
5. tabModel->setSort(tabModel->fieldIndex("empNo"),Qt::AscendingOrder); //排序
6. if (!(tabModel->select()))//查询数据
7. {
8.    QMessageBox::critical(this, "错误信息",
9.           "打开数据表错误,错误信息\n"+tabModel->lastError().text(),
10.              QMessageBox::Ok,QMessageBox::NoButton);
11.    return;
12. }

复制代码

• 创建数据库模型且指定命据库的连接
  通过往 QSqlTableModel 构造函数中传入参数来指定命据库连接
  构造函数为：
  
  1. QSqlTableModel::QSqlTableModel(QObject *parent = nullptr, QSqlDatabase db = QSqlDatabase())

  复制代码
  在本案例中为
  
  1. tabModel=new QSqlTableModel(this,DB);//数据表

  复制代码
• 使用 setTable() 函数来指定命据表，此时不会立即读取记录，但会提取字段信息
  
  1. [virtual] void QSqlTableModel::setTable(const QString &tableName)

  复制代码
  在本案例中为
  
  1. tabModel->setTable("employee"); //设置数据表

  复制代码
• 使用 setSort() 函数设置排序字段与排序规则，需调用 select() 函数才生效
  
  1. [virtual] void QSqlTableModel::setSort(int column, Qt::SortOrder order)

  复制代码
  
  
  • 第一个参数 column 是排序字段的列号
    
  • 第二个参数 order 是枚举范例Qt::SortOrder，表示排序方式，此中，Qt::AscendingOrder表示升序，Qt:escendingOrder表示降序
    
  在本案例中为
  
  1. tabModel->setSort(tabModel->fieldIndex("empNo"),Qt::AscendingOrder); //排序

  复制代码
  
  
• 使用 setEditStrategy() 函数用于设置编辑计谋
  
  1. [virtual] void QSqlTableModel::setEditStrategy(QSqlTableModel::EditStrategy strategy)

  复制代码
  
  
  • 参数 strategy 是枚举范例 QSqlTableModel::EditStrategy，各取值的意义如下：
    
    
    
    • QSqlTableModel::OnFieldChange：字段值厘革时立即更新到数据库
      
    • QSqlTableModel::OnRowChange：当前行（记录）变更时更新到数据库
      
    • QSqlTableModel::OnManualSubmit：所有修改暂时缓存，手动调用 submitAll() 生存所有修改，或调用 revertAll() 函数取消所有未生存的修改。
      
    
    
  
  
• 使用 select() 函数查询数据表的数据，并使用设置的排序和过滤规则
  
  1. [virtual slot] bool QSqlTableModel::select()

  复制代码
  
  
  • 如果成功打开则返回true，否则，返回false
    
  在本案例中为：
  
  1. tabModel->select()

  复制代码
  
  

表头设置：
  使用 setHeaderData() 函数设置表头，即设置数据库表的字段在 tableView 中表现时的字段名称。为此，将每个字段的表现设置为相应的中文标题。

1. [override virtual] bool QSqlQueryModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)

复制代码

• 参数 section 是字段的序号，通过 fieldIndex() 函数可以获取某个字段名在数据模型里的序号
  
• 参数 orientation 是字段的方向，此中，Qt::Horizontal表示是水平方向标题，Qt::Vertical表示是竖直方向标题
  
• 参数 value 是要设置的值
  

表头设置部分代码为：

1.     tabModel->setHeaderData(tabModel->fieldIndex("empNo"),Qt::Horizontal,"工号");
2.     tabModel->setHeaderData(tabModel->fieldIndex("Name"),Qt::Horizontal,"姓名");
3.     tabModel->setHeaderData(tabModel->fieldIndex("Gender"),Qt::Horizontal,"性别");
4.     tabModel->setHeaderData(tabModel->fieldIndex("Height"),Qt::Horizontal,"身高");
5.     tabModel->setHeaderData(tabModel->fieldIndex("Birthday"),Qt::Horizontal,"出生日期");
6.     tabModel->setHeaderData(tabModel->fieldIndex("Mobile"),Qt::Horizontal,"手机");
7.     tabModel->setHeaderData(tabModel->fieldIndex("Province"),Qt::Horizontal,"省份");
8.     tabModel->setHeaderData(tabModel->fieldIndex("City"),Qt::Horizontal,"城市");
9.     tabModel->setHeaderData(tabModel->fieldIndex("Department"),Qt::Horizontal,"部门");
10.     tabModel->setHeaderData(tabModel->fieldIndex("Education"),Qt::Horizontal,"学历");
11.     tabModel->setHeaderData(tabModel->fieldIndex("Salary"),Qt::Horizontal,"工资");
13.     tabModel->setHeaderData(tabModel->fieldIndex("Memo"),Qt::Horizontal,"备注"); //这两个字段不再tableView中显示
14.     tabModel->setHeaderData(tabModel->fieldIndex("Photo"),Qt::Horizontal,"照片");

复制代码

创建选择模型及信号的作用：
  选择模型的作用是当用户在 TableView 组件上操作时，获取当前选择的行 、列信息，而且在选择的单位格厘革时发射 currentChanged() 信号，在当前行厘革时发射 currentRowChanged() 信号。

1. theSelection=new QItemSelectionModel(tabModel);//关联选择模型
2. //theSelection当前项变化时触发currentChanged信号
3. connect(theSelection,SIGNAL(currentChanged(QModelIndex,QModelIndex)),
4.         this,SLOT(on_currentChanged(QModelIndex,QModelIndex)));
5. //选择行变化时
6. connect(theSelection,SIGNAL(currentRowChanged(QModelIndex,QModelIndex)),
7.         this,SLOT(on_currentRowChanged(QModelIndex,QModelIndex)));

复制代码

对应的槽函数为：

1. void MainWindow::on_currentChanged(const QModelIndex &current, const QModelIndex &previous)
2. {//更新actPost和actCancel 的状态
3.     Q_UNUSED(current);
4.     Q_UNUSED(previous);
5.     ui->actSubmit->setEnabled(tabModel->isDirty()); //有未保存修改时可用
6.     ui->actRevert->setEnabled(tabModel->isDirty());
7. }
9. void MainWindow::on_currentRowChanged(const QModelIndex &current, const QModelIndex &previous)
10. {
11.     Q_UNUSED(previous);
12. // 行切换时的状态控制
13.     ui->actRecDelete->setEnabled(current.isValid());
14.     ui->actPhoto->setEnabled(current.isValid());
15.     ui->actPhotoClear->setEnabled(current.isValid());
17.     if (!current.isValid())
18.     {
19.         ui->dbLabPhoto->clear(); //清除图片显示
20.         return;
21.     }
23.     dataMapper->setCurrentIndex(current.row()); //更新数据映射到当前行，使界面上的编辑框、下拉列表框等与字段关联的界面组件显示当前记录的内容
25.     int curRecNo=current.row();//获取行号
26.     QSqlRecord  curRec=tabModel->record(curRecNo); //获取当前记录
28.     if (curRec.isNull("Photo"))  //图片字段内容为空
29.        ui->dbLabPhoto->clear();
30.     else
31.     {
32.         QByteArray data=curRec.value("Photo").toByteArray();
33.         QPixmap pic;
34.         pic.loadFromData(data);
35.         ui->dbLabPhoto->setPixmap(pic.scaledToWidth(ui->dbLabPhoto->size().width()));
36.     }
37. }

复制代码

tableView的设置：
  用 QTableView 组件表现 tabModel 的表格数据内容时，需要设置其数据模型和关联选择模型，而且将 “Memo” 和 “Photo” 两个字段的列设置为隐藏，由于在表格里难以表现备注文件和图片。

1. ui->tableView->setModel(tabModel);//设置数据模型
2. ui->tableView->setSelectionModel(theSelection); //设置选择模型
3. ui->tableView->setColumnHidden(tabModel->fieldIndex("Memo"),true);//隐藏列
4. ui->tableView->setColumnHidden(tabModel->fieldIndex("Photo"),true);//隐藏列

复制代码

  自界说基于 QComboBox 的代理组件类 QWComboBoxDelegate，组件类中有一个函数 setItems() ，用于初始化下拉列表框和设置是都可以编辑，
qwcombocoxdelegate.h：

1. #ifndef QWCOMBOBOXDELEGATE_H
2. #define QWCOMBOBOXDELEGATE_H
4. #include    <QStyledItemDelegate>
5. #include    <QComboBox>
7. class QWComboBoxDelegate : public QStyledItemDelegate
8. {
9.     Q_OBJECT
11. private:
12.     QStringList m_ItemList;//选择列表
13.     bool    m_isEdit; //是否可编辑
15. public:
16.     QWComboBoxDelegate(QObject *parent=0);
18.     void    setItems(QStringList items, bool isEdit);//初始化设置列表内容，是否可编辑
19. //自定义代理组件必须继承以下4个函数
20.     QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem &option,
21.                           const QModelIndex &index) const Q_DECL_OVERRIDE;
23.     void setEditorData(QWidget *editor, const QModelIndex &index) const Q_DECL_OVERRIDE;
24.     void setModelData(QWidget *editor, QAbstractItemModel *model,
25.                       const QModelIndex &index) const Q_DECL_OVERRIDE;
26.     void updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option,
27.                               const QModelIndex &index) const Q_DECL_OVERRIDE;
28. };
30. #endif // QWCOMBOBOXDELEGATE_H

复制代码

qwcombocoxdelegate.cpp：

1. #include "qwcomboboxdelegate.h"
3. #include    <QComboBox>
5. QWComboBoxDelegate::QWComboBoxDelegate(QObject *parent):QStyledItemDelegate(parent)
6. {
8. }
10. void QWComboBoxDelegate::setItems(QStringList items, bool isEdit)
11. {
12.     m_ItemList=items;
13.     m_isEdit=isEdit;
14. }
16. QWidget *QWComboBoxDelegate::createEditor(QWidget *parent,
17.        const QStyleOptionViewItem &option, const QModelIndex &index) const
18. {
19.     Q_UNUSED(option);
20.     Q_UNUSED(index);
22.     QComboBox *editor = new QComboBox(parent);
23.     for (int i=0;i<m_ItemList.count();i++)   //从字符串列表初始下拉列表
24.         editor->addItem(m_ItemList.at(i));
26.     editor->setEditable(m_isEdit); //是否可编辑
27.     return editor;
28. }
30. void QWComboBoxDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const
31. {
32.     QString str = index.model()->data(index, Qt::EditRole).toString();
34.     QComboBox *comboBox = static_cast<QComboBox*>(editor);
35.     comboBox->setCurrentText(str);
36. }
38. void QWComboBoxDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const
39. {
40.     QComboBox *comboBox = static_cast<QComboBox*>(editor);
41.     QString str = comboBox->currentText();
42.     model->setData(index, str, Qt::EditRole);
43. }
45. void QWComboBoxDelegate::updateEditorGeometry(QWidget *editor,
46.                 const QStyleOptionViewItem &option, const QModelIndex &index) const
47. {
48.     Q_UNUSED(index);
49.     editor->setGeometry(option.rect);
50. }

复制代码

  创建多个代理组件实例，分别用于“性别” 和 “部分” 两个字段。

1. //tableView上为“性别”和“部门”两个字段设置自定义代理组件
2. QStringList strList;
3. strList<<"男"<<"女";
4. bool isEditable=false;
5. delegateSex.setItems(strList,isEditable);
6. ui->tableView->setItemDelegateForColumn(
7.    tabModel->fieldIndex("Gender"),&delegateSex); //Combbox选择型
9. strList.clear();
10. strList<<"销售部"<<"技术部"<<"生产部"<<"行政部";
11. isEditable=true;
12. delegateDepart.setItems(strList,isEditable);
13. ui->tableView->setItemDelegateForColumn(tabModel->fieldIndex("Department"),&delegateDepart); //Combbox选择型

复制代码

数据映射：
  QDataWidgetMapper 用于建立界面组件与数据模型之间的映射，可以将界面的 QLineEdit、QCombobox 等组件与数据模型的一个字段关联起来。当数据模型关联的字段内容发生厘革时，自动更新组件的表现内容。

1. //创建界面组件与数据模型的字段之间的数据映射
2. dataMapper= new QDataWidgetMapper();
3. dataMapper->setModel(tabModel);//设置数据模型
4. dataMapper->setSubmitPolicy(QDataWidgetMapper::AutoSubmit);//
6. //    dataMapper->setItemDelegate(new QSqlRelationalDelegate(this)); //含有外键的
7. //界面组件与tabModel的具体字段之间的联系
8. dataMapper->addMapping(ui->dbSpinEmpNo,tabModel->fieldIndex("empNo"));
9. dataMapper->addMapping(ui->dbEditName,tabModel->fieldIndex("Name"));
10. dataMapper->addMapping(ui->dbComboSex,tabModel->fieldIndex("Gender"));
12. dataMapper->addMapping(ui->dbSpinHeight,tabModel->fieldIndex("Height"));
13. dataMapper->addMapping(ui->dbEditBirth,tabModel->fieldIndex("Birthday"));
14. dataMapper->addMapping(ui->dbEditMobile,tabModel->fieldIndex("Mobile"));
16. dataMapper->addMapping(ui->dbComboProvince,tabModel->fieldIndex("Province"));
17. dataMapper->addMapping(ui->dbEditCity,tabModel->fieldIndex("City"));
18. dataMapper->addMapping(ui->dbComboDep,tabModel->fieldIndex("Department"));
20. dataMapper->addMapping(ui->dbComboEdu,tabModel->fieldIndex("Education"));
21. dataMapper->addMapping(ui->dbSpinSalary,tabModel->fieldIndex("Salary"));
23. dataMapper->addMapping(ui->dbEditMemo,tabModel->fieldIndex("Memo"));
25. //    dataMapper->addMapping(ui->dbPhoto,tabModel->fieldIndex("Photo")); //图片无法直接映射
27. dataMapper->toFirst();//移动到首记录
29. getFieldNames();//获取字段名称列表，填充ui->groupBoxSort组件
31. //更新actions和界面组件的使能状态
32. ui->actOpenDB->setEnabled(false);
34. ui->actRecAppend->setEnabled(true);
35. ui->actRecInsert->setEnabled(true);
36. ui->actRecDelete->setEnabled(true);
37. ui->actScan->setEnabled(true);
39. ui->groupBoxSort->setEnabled(true);
40. ui->groupBoxFilter->setEnabled(true);

复制代码

• setModel() 函数–设置关联的数据模型
  
  1. void QDataWidgetMapper::setModel(QAbstractItemModel *model)

  复制代码
  用于设置 QDataWidgetMapper 将要使用的数据模型。参数 model 是一个指向 QAbstractItemModel 范例的指针
  
• setSubmitPolicy() 函数–设置数据提交计谋
  
  1. void setSubmitPolicy(QDataWidgetMapper::SubmitPolicy policy)

  复制代码
  其参数policy是一个枚举范例QDataWidgetMapper::SubmitPolicy。取值如下：
  
  
  
  • QDataWidgetMapper::AutoSubmit：自动，行切换时将自动提交修改。
    
  • QDataWidgetMapper::ManualSubmit：手动，需调用 submit() 方法，手工提交当前记录的修改。
    
  
  
• addMapping() 函数 – 用于设置界面组件与数据模型的列的映射，这种映射关系使得控件的值可以与数据模型中的特定项关联起来
  
  1. void QDataWidgetMapper::addMapping(QWidget *widget, int section)

  复制代码
  参数 widget 是指向 UI 控件的指针，section 指定了数据模型中的列（如果方向是水平的）或行（如果方向是垂直的）
  
• setCurrentIndex() 函数 – 将当前行数据映射到界面组件， 使界面上的编辑框、下拉列表框等与字段关联的界面组件表现当前记录的内容
  
  1. virtual void setCurrentIndex(int index)

  复制代码
  例如：
  
  1. dataMapper->setCurrentIndex(current.row()); //更新当前行数据映射

  复制代码
• setCurrentModelIndex() 函数–当用户在视图中选择不同的行或列时，自动更新与之关联的表单或控件的数据。
  
  1. [slot] void QDataWidgetMapper::setCurrentModelIndex(const QModelIndex &index)

  复制代码
• revert() 和 submit() 函数用于手工取消或提交当前记录的修改。
  
• toFirst()、toPrevious()、toNext() 和 toLast() 函数用于在记录间移动
  如：toFirst()函数用于移动到首记录
  

获取数据表的所有字段名称：
  使用不带参数的 record() 函数获取数据表的所有字段名称，并添补到排序的下拉列表框中

1. void MainWindow::getFieldNames()
2. { //获取所有字段名称
3.     QSqlRecord  emptyRec=tabModel->record();//获取空记录，只有字段名
4.     for (int i=0;i<emptyRec.count();i++)
5.         ui->comboFields->addItem(emptyRec.fieldName(i));
6. }

复制代码

4.添加、插入与删除记录

  使用 insertRow() 函数在数据模型的 row 行前面插入一行记录，如果 row 大于或即是数据模型的总行数，则在末了添加一行记录。末了，选中刚插入的那一行记录。

1. void MainWindow::on_actRecAppend_triggered()
2. {//添加记录
3.     tabModel->insertRow(tabModel->rowCount(),QModelIndex()); //在末尾添加一个记录
5.     QModelIndex curIndex=tabModel->index(tabModel->rowCount()-1,1);//创建最后一行的ModelIndex
6.     theSelection->clearSelection();//清空选择项
7.     theSelection->setCurrentIndex(curIndex,QItemSelectionModel::Select);//设置刚插入的行为当前选择行
9.     int currow=curIndex.row(); //获得当前行
10.     tabModel->setData(tabModel->index(currow,0),2000+tabModel->rowCount()); //自动生成编号
11.     tabModel->setData(tabModel->index(currow,2),"男");
12. // 插入行时设置缺省值，需要在primeInsert()信号里去处理
13. }
15. void MainWindow::on_actRecInsert_triggered()
16. {//插入记录
17.     QModelIndex curIndex=ui->tableView->currentIndex();
19.     tabModel->insertRow(curIndex.row(),QModelIndex());
21.     theSelection->clearSelection();//清除已有选择
22.     theSelection->setCurrentIndex(curIndex,QItemSelectionModel::Select);
23. }

复制代码

  使用 removeRow() 函数删除选中的那一行记录。

1. void MainWindow::on_actRecDelete_triggered()
2. {//删除当前记录
3.     QModelIndex curIndex=theSelection->currentIndex();//获取当前选择单元格的模型索引
4.     tabModel->removeRow(curIndex.row()); //删除最后一行
5. }

复制代码

在插入或删除记录操作，未提交生存之前， tableView 的左侧表头会以标记表示记录编辑状态，"*"表示新插入的记录，”!” 表示删除的记录 。在生存或取消修改，这些标记就消失，删除的记录行也从 tableView 里删除。
5.生存与取消修改

  在打开数据表初始化时，设置数据模型的编辑计谋为 OnManualSubmit，即手动提交修改。当数据模型的数据被修改后，不管是直接修改字段值，照旧插入或删除记录，在未提交修改前，QSqlTableModel::isDirty() 函数返回 true，就是使用这个函数在槽函数 on_currentChanged() 里设置 ”生存修改“和”取消修改“ 按钮的使能状态。
  使用 submitAll() 函数用于将数据表所有未提交的修改生存到数据库中；使用 revertAll() 函数来取消所有修改。

1. void MainWindow::on_actRevert_triggered()
2. {//取消修改
3.     tabModel->revertAll();
4.     ui->actSubmit->setEnabled(false);
5.     ui->actRevert->setEnabled(false);
6. }
8. void MainWindow::on_actSubmit_triggered()
9. {//保存修改
10.     bool res=tabModel->submitAll();
12.     if (!res)
13.         QMessageBox::information(this, "消息", "数据保存错误,错误信息\n"+tabModel->lastError().text(),
14.                                  QMessageBox::Ok,QMessageBox::NoButton);
15.     else
16.     {
17.         ui->actSubmit->setEnabled(false);
18.         ui->actRevert->setEnabled(false);
19.     }
20. }

复制代码

6.设置和清除照片

  设置照片功能是用文件对话框选择一个图片文件，读取文件内容到 QByteArray 范例的变量data里，获取当前记录到变量 curRec 后，用 QSqlRecord 的 setValue() 函数为 Photo 字段设置数据为 data，然后用 setRecord() 函数更新当前记录的数据到数据模型，并在界面组件上表现。
   留意：这里的更新只是更新到数据模型，并没有更新到数据库。

1. void MainWindow::on_actPhoto_triggered()
2. {
3. //设置照片
4.     QString aFile=QFileDialog::getOpenFileName(this,"选择图片文件","","照片(*.jpg)");
5.     if (aFile.isEmpty())
6.        return;
8.     QByteArray data;
9.     QFile* file=new QFile(aFile); //fileName为二进制数据文件名
10.     file->open(QIODevice::ReadOnly);
11.     data = file->readAll();
12.     file->close();
14.     int curRecNo=theSelection->currentIndex().row();
15.     QSqlRecord  curRec=tabModel->record(curRecNo); //获取当前记录
16.     curRec.setValue("Photo",data); //设置字段数据
17.     tabModel->setRecord(curRecNo,curRec);
19.     QPixmap pic;
20.     pic.load(aFile);  //在界面上显示
21.     ui->dbLabPhoto->setPixmap(pic.scaledToWidth(ui->dbLabPhoto->width()));
22. }

复制代码

  清楚照片的功能是获取当前记录到变量 curRec 后，调用 setNull () 函数将 Photo 字段设置为 NULL，就是清除了字段的内容，然后更新记录到数据模型，并清除界面组件的表现。

1. void MainWindow::on_actPhotoClear_triggered()
2. {
3.     int curRecNo=theSelection->currentIndex().row();
4.     QSqlRecord  curRec=tabModel->record(curRecNo); //获取当前记录
6.     curRec.setNull("Photo");//设置为空值
7.     tabModel->setRecord(curRecNo,curRec);
9.     ui->dbLabPhoto->clear();
10. }

复制代码

7.数据记录的遍历

  使用 record(int index) 函数获取每一行记录，并对该行记录的值举行修改。

1. void MainWindow::on_actScan_triggered()
2. {//涨工资，记录遍历
3.     if (tabModel->rowCount()==0)
4.         return;
6.     for (int i=0;i<tabModel->rowCount();i++)
7.     {
8.         QSqlRecord aRec=tabModel->record(i); //获取当前记录
9.         float salary=aRec.value("Salary").toFloat();
10.         salary=salary*1.1;
11.         aRec.setValue("Salary",salary);
12.         tabModel->setRecord(i,aRec);
13.     }
15. // 索引方式刷新记录,速度一样
16. //    float   salary;
17. //    for (int i=0;i<tabModel->rowCount();i++)
18. //    {
19. //        salary=tabModel->data(tabModel->index(i,10)).toFloat();
20. //        salary=salary*1.1;
21. //        tabModel->setData(tabModel->index(i,10),salary);
22. //    }
24.     if (tabModel->submitAll())
25.         QMessageBox::information(this, "消息", "涨工资计算完毕",
26.                              QMessageBox::Ok,QMessageBox::NoButton);
27. }

复制代码

8.记录排序

  使用 setSort() 函数设置数据表根据某个字段按照升序或降序排列，实际上就是设置 SQL 语句里的 ORDER BY 子句。在调用 setSort() 函数设置排序规则后，需要调用 QSqITableModel::select() 重新读取数据表的数据才会使排序规则生效。

1. void MainWindow::on_comboFields_currentIndexChanged(int index){//选择字段举行排序    if (ui->radioBtnAscend->isChecked())        tabModel->setSort(index,Qt::AscendingOrder);    else        tabModel->setSort(index,Qt::DescendingOrder);    tabModel->select()
2. ;}void MainWindow::on_radioBtnAscend_clicked(){//升序    tabModel->setSort(ui->comboFields->currentIndex(),Qt::AscendingOrder);    tabModel->select()
3. ;}void MainWindow::on_radioBtnDescend_clicked(){//降序    tabModel->setSort(ui->comboFields->currentIndex(),Qt::DescendingOrder);    tabModel->select()
4. ;}

复制代码

9.记录过滤

  使用 setFilter() 函数设置记录的过滤条件，实际上就是设置 SQL 语句里的 WHERE 子句。调用 setFilter() 后无需调用 select() 函数就可以立即刷新记录，若要取消过滤条件，只需在 setFilter() 函数里传递一个空字符串。

1. void MainWindow::on_radioBtnMan_clicked(){    tabModel->setFilter(" Gender='男' ");//    tabModel->select()
2. ;}void MainWindow::on_radioBtnWoman_clicked(){    tabModel->setFilter(" Gender='女' ");//    tabModel->select()
3. ;}void MainWindow::on_radioBtnBoth_clicked(){    tabModel->setFilter("");}

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。