C++ Qt开发:数据库与TableView多组件联动
Qt 是一个跨平台C++图形界面开发库,利用Qt可以快速开发跨平台窗体应用程序,在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置,实现图形化开发极大的方便了开发效率,本章将重点介绍TableView
组件与数据库联动的常用方法及灵活运用。
在Qt中,通常我们不会在TableView
等组件中保存数据,一般会将这些数据存储至数据库或者是文件中保存,当使用时则动态的在数据库中调出来,以下案例将实现,当用户点击并选中TableView
组件内的某一行时,我们通过该行中的name
字段查询,并将查询结果关联到ListView
组件内,同时将TableView
中选中行的字段分别显示在窗体底部的LineEdit
编辑框内。
要实现联动涉及几个主要步骤:建立数据库连接、创建模型、设置TableView
、捕捉TableView
的选中信号、查询并关联数据、更新LineEdit
和ListView
,首先我们在UI
界面中绘制所需控件,如下图左侧放一个TableView
组件,右侧是一个ListView
组件,底部放三个LineEdit
组件;
接着我们需要创建两张数据表,其中Student
表主要用来存储学生信息,而StudentAddressList
用于存储学生所管理的IP地址,我们将表中的name
进行关联,每个学生名下存储有不同的地址;
创建两个表结构总结起来代码如下所示,通过分别调用多次db.exec()
函数实现创建数据表,并通过QSqlQuery
类实现批量插入数据集;
void InitMultipleSQL() |
1.1 初始化组件
接着我们需要在构造函数MainWindow::MainWindow(QWidget *parent)
内初始化``TableView表格,查询
Student表内记录,将查询到的指针绑定到
theSelection模型上,绑定后再将绑定指针加入到
dataMapper组件映射中,即可实现初始化,这里有必要介绍一下
QSqlQueryModel、
QItemSelectionModel、
QDataWidgetMapper`这三个模型类。
QSqlQueryModel
用于与数据库交互的模型类之一,它继承自 QAbstractTableModel
。QSqlQueryModel
通过执行 SQL 查询语句,将查询结果作为表格数据提供给 Qt 的视图组件,如 QTableView
等。
以下是 QSqlQueryModel
的一些常用方法,概述成表格形式:
方法 | 描述 |
---|---|
setQuery(const QString &query, const QSqlDatabase &db = QSqlDatabase()) |
设置要执行的 SQL 查询和数据库连接。查询执行后,结果将被提供给模型。 |
clear() |
清除模型中的数据。 |
lastError() const |
返回最后一次执行的查询的错误。 |
record() const |
返回包含查询结果字段信息的 QSqlRecord 对象。 |
data(const QModelIndex &item, int role = Qt::DisplayRole) const |
返回与给定索引处的项相关联的数据,用于提供给视图请求的数据。 |
rowCount(const QModelIndex &parent = QModelIndex()) const |
返回模型中的行数。 |
columnCount(const QModelIndex &parent = QModelIndex()) const |
返回模型中的列数。 |
上述方法提供了一般性的查询执行、错误处理、结果处理等功能,使得通过 QSqlQueryModel
能够方便地将数据库中的查询结果集与 Qt 的视图组件进行关联。使用这些方法,你可以在应用中执行 SQL 查询,并将结果显示在相应的视图组件中。
QItemSelectionModel
用于管理项选择的模型类,它是 QAbstractItemModel
类的衍生类。QItemSelectionModel
用于追踪一个或多个视图中的选择项,同时允许对这些选择项进行查询和修改。
以下是 QItemSelectionModel
的一些常用方法,概述成表格形式:
方法 | 描述 |
---|---|
QItemSelectionModel(QAbstractItemModel *model) |
构造函数,创建一个选择模型并关联指定的数据模型。 |
setModel(QAbstractItemModel *model) |
设置关联的数据模型。 |
model() const |
返回与此选择模型相关联的数据模型。 |
currentIndex() const |
返回当前焦点的项的索引。 |
selectedIndexes() const |
返回当前选择的项的索引列表。 |
clear() |
清除模型中的所有选择项。 |
select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command) |
根据给定的 QModelIndex 对象和选择标志执行选择操作。 |
select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags command) |
根据给定的 QItemSelection 对象和选择标志执行选择操作。 |
reset() |
重置选择模型,清除所有选择和当前索引。 |
setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command) |
设置当前焦点项。 |
currentIndexChanged(const QModelIndex ¤t, const QModelIndex &previous) |
当前焦点项变化时发出的信号。 |
selectionChanged(const QItemSelection &selected, const QItemSelection &deselected) |
选择发生变化时发出的信号。 |
这些方法允许你在一个或多个视图中管理选择项,进行选择的查询、修改,以及处理选择变化的信号。通过使用这些方法,你可以实现对模型中的项进行灵活的选择操作,并及时响应选择的变化。
QDataWidgetMapper
用于实现数据和小部件之间双向映射的类,使得数据模型的变化能够反映在界面上,同时用户界面的修改也能够同步到数据模型中。
以下是 QDataWidgetMapper
的一些主要方法,概述成表格形式:
方法 | 描述 |
---|---|
QDataWidgetMapper(QObject *parent = nullptr) |
构造函数,创建一个数据映射器对象。 |
setModel(QAbstractItemModel *model) |
设置映射的数据模型。 |
model() const |
返回与此数据映射器相关联的数据模型。 |
addMapping(QWidget *widget, int section) |
将指定的小部件和数据模型的字段进行映射。 |
removeMapping(QWidget *widget) |
移除与指定小部件的映射关系。 |
mappedWidgetAt(int section) const |
返回与数据模型的指定字段映射的小部件。 |
mappedSection(QWidget *widget) const |
返回与指定小部件映射的数据模型字段的索引。 |
setCurrentIndex(int index) |
将映射的数据移动到指定的索引。 |
currentIndex() const |
返回当前映射的数据的索引。 |
toFirst(), toLast(), toNext(), toPrevious() |
分别将映射的数据移动到第一行、最后一行、下一行、上一行。 |
submit() |
将界面上的更改提交到模型。 |
revert() |
撤销所有未提交的更改。 |
setSubmitPolicy(QDataWidgetMapper::SubmitPolicy policy) |
设置更改提交策略。 |
submitPolicy() const |
返回当前的更改提交策略。 |
addMapping(QWidget *widget, int section, const QByteArray &propertyName) |
将小部件和数据模型字段以及小部件属性进行映射。 |
toFirst(), toLast(), toNext(), toPrevious() |
分别将映射的数据移动到第一行、最后一行、下一行、上一行。 |
这些方法使得在 Qt 应用程序中更容易实现数据模型和用户界面的交互,通过将数据模型字段映射到用户界面的小部件上,实现了数据的显示和编辑的同步。通过调用 setCurrentIndex
、toNext
、toPrevious
等方法,你可以在数据模型中移动,并自动更新映射的小部件上显示的数据。最后,通过调用 submit
将界面上的更改提交到模型,而 revert
则撤销未提交的更改。
初始化UI界面很容易实现,首席按初始化表结构,通过调用封装好的InitMultipleSQL
可以直接初始化并将数据保存至database.db
文件中,在主程序中我们一次执行如下操作来实现数据的初始化与展现。
打开数据库
使用 SQLite 数据库,并尝试打开名为 “database.db” 的数据库文件。如果打开失败,将输出错误信息并返回。需要注意确保数据库文件存在且可访问。
QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE"); |
查询数据表中记录
通过 QSqlQueryModel
查询 Student 表中的所有记录,并按 id 排序。如果查询过程中出现错误,需要处理错误。
qryModel=new QSqlQueryModel(this); |
设置 TableView 表头数据
设置查询模型的表头数据,分别为 “ID”、”Name”、”Age”。
qryModel->setHeaderData(0,Qt::Horizontal,"ID"); |
绑定数据到模型和 TableView
创建一个 QItemSelectionModel
对象 theSelection
,并将其绑定到查询模型 qryModel
上。然后将模型和选择模型分别绑定到 ui->tableView
上,设置选择行为为按行选择。
theSelection=new QItemSelectionModel(qryModel); |
创建数据映射器 QDataWidgetMapper
创建 QDataWidgetMapper
对象 dataMapper
,设置提交策略为自动提交。然后将映射器和模型绑定,并将三个文本框小部件与模型的相应字段进行映射。最后,将映射器移动到第一行。
dataMapper= new QDataWidgetMapper(); |
绑定信号
连接 theSelection
的 currentRowChanged
信号到槽函数 on_currentRowChanged
。这样,当用户在表格中选择不同行时,将触发槽函数执行相应的操作。
connect(theSelection,SIGNAL(currentRowChanged(QModelIndex,QModelIndex)), |
上述代码实现了组件初始化,使用数据库表格中的数据填充了一个 QTableView
,并通过 QDataWidgetMapper
将选中行的数据映射到三个文本框中,同时通过信号槽机制实现了在底部编辑框中显示当前选中行的功能。
1.2 绑定事件
接着我们需要绑定TableView
表格的on_currentRowChanged()
事件,当用户点击TableView
表格中的某个属性时则自动触发该函数,在此函数内我们完成对其他组件的填充,如下是对绑定事件的具体分析。
如下这部分代码使用了 Q_UNUSED
宏,用于标记 previous
未使用,以避免编译器产生未使用变量的警告。接着判断 current
是否有效,如果无效则直接返回,避免出现错误。
Q_UNUSED(previous); |
这段代码判断当前行是否为表格的第一行或最后一行,并输出相应的信息。
// 获取到记录开头结尾 |
获取当前选择行的 name
字段的数据,并输出到标准输出流。
// 获取name字段数据 |
代码查询名为 StudentAddressList
的表中与当前用户名匹配的所有数据,并将 address
字段的数据提取出来存储在 the_data
容器中。
// 查StudentAddressList表中所有数据 |
最后,将 the_data
中的数据关联到 QListView
控件上,并设置为不可编辑。这样,用户就可以在 QListView
中看到与当前表格行对应的地址信息。
// 关联到ListView数据表中 |
至此核心功能的实现就结束了,通过对信号的绑定,当读者运行程序并选中TableView
组件中的任意一行是,其右侧ListView
与底部的LineEdit
编辑框均会实现联动效果,如下图所示;