当前位置：首页 > news >正文

Qt 中基于 QTableView + QSqlTableModel 的分页搜索与数据管理实现

news 来源：原创 2025/5/3 17:11:23

Qt 中基于 QTableView + QSqlTableModel 的分页搜索与数据管理实现

一、组件说明

QTableView：一个基于模型的表格视图控件，支持排序、选择、委托自定义。
QSqlTableModel：与数据库表直接绑定的模型类，可用于展示和编辑数据库表数据，适合与 QTableView 配合使用。

二、主要功能

1. 分页显示数据

通过 SQL 的 LIMIT 和 OFFSET 控制当前页显示的数据数量与起始位置，结合当前页码和每页条数，动态更新 QSqlTableModel：

QString limitClause = QString("LIMIT %1 OFFSET %2").arg(pageSize).arg(currentPage * pageSize);
model->setFilter(...); // 可附加 WHERE 子句
model->select();

2. 搜索过滤

使用 model->setFilter(...) 实现字段模糊查询，例如：

QString term = searchEdit->text().trimmed();
QString filter = QString("name LIKE '%%1%'").arg(term);
model->setFilter(filter);
model->select();

3. 排序功能

启用视图的排序能力，用户可点击表头排序：

view->setSortingEnabled(true);

4. 添加数据

通过 QSqlQuery 插入记录：

QSqlQuery q;
q.prepare("INSERT INTO people (name, age) VALUES (?, ?)");
q.addBindValue("New User");
q.addBindValue(30);
q.exec();

插入后刷新模型：

model->select();

5. 导出为 CSV 文件

遍历模型中的数据，保存为 .csv 文件：

QFile file("export.csv");
QTextStream out(&file);
for (int row = 0; row < model->rowCount(); ++row) {QStringList rowContent;for (int col = 0; col < model->columnCount(); ++col)rowContent << model->data(model->index(row, col)).toString();out << rowContent.join(",") << "\n";
}

三、分页控制逻辑

当前页：currentPage
每页记录数：pageSize
总记录数通过 SQL 查询统计：

QSqlQuery countQuery;
countQuery.exec("SELECT COUNT(*) FROM people WHERE ...");
int totalRows = countQuery.next() ? countQuery.value(0).toInt() : 0;

计算总页数：

int totalPages = (totalRows + pageSize - 1) / pageSize;

上一页 / 下一页按钮控制页码，并重新加载模型：

--currentPage; loadPage();
++currentPage; loadPage();

四、界面推荐布局

控件	用途
`QLineEdit`	输入搜索关键词
`QPushButton`	搜索、分页切换等按钮
`QLabel`	显示页码信息
`QTableView`	显示数据表格
`QVBoxLayout`	垂直布局整体界面
`QHBoxLayout`	控制顶部搜索条和底部分页按钮