Qt学习笔记

QTabWidget相关笔记：#

创建QTabWidget对象(这里只是创建了对象没有标签页，需要添加后才会有)

1
QTabWidget *tabWidget = new QTabWidget(this);

设置初始显示项（可在构造函数中设置）

1
// 确保默认显示第一个标签页
2
ui->tabWidget->setCurrentIndex(0);

添加标签页

1
// 添加标签页
2
ui->tabWidget->addTab(new QWidget(), "新标签页");

切换标签页

1
// 切换到第二个标签页
2
ui->tabWidget->setCurrentIndex(1);

获取当前标签页索引

1
// 获取当前选中的标签页索引
2
int currentIndex = ui->tabWidget->currentIndex();

获取标签页数量

1
// 获取标签页数量
2
int tabCount = ui->tabWidget->count();

删除标签页

1
// 删除第二个标签页
2
ui->tabWidget->removeTab(1);

获取标签页标题

1
// 获取第二个标签页的标题
2
QString tabText = ui->tabWidget->tabText(1);

设置标签页标题

1
// 设置第二个标签页的标题
2
ui->tabWidget->setTabText(1, "新标题");

获取标签页图标

1
// 获取第二个标签页的图标
2
QIcon tabIcon = ui->tabWidget->tabIcon(1);

设置标签页图标

1
// 设置第二个标签页的图标
2
ui->tabWidget->setTabIcon(1, QIcon(":/icon/2.png"));

QTableWidget相关笔记：#

设置行数

1
// 设置表格行数
2
ui->tableWidget->setRowCount(3);

设置列数

1
// 设置表格列数
2
ui->tableWidget->setColumnCount(3);

设置表头（水平方向）

1
// 设置表格表头
2
ui->tableWidget->setHorizontalHeaderLabels({"姓名", "年龄", "性别"});

表头的数量与列数相同，即3列就有3个表头。

设置表头（垂直方向）

1
// 设置表格表头
2
ui->tableWidget->setVerticalHeaderLabels({"行1", "行2", "行3"});

表头的数量与行数相同，即3行就有3个表头。

隐藏垂直表头（行号）

1
// 隐藏垂直表头（行号）
2
ui->tableWidget->verticalHeader()->setVisible(false);

隐藏水平表头（列号）

1
// 隐藏水平表头（列号）
2
ui->tableWidget->horizontalHeader()->setVisible(false);

设置表格的列宽

1
// 设置表格的列宽
2
ui->tableWidget->setColumnWidth(0, 100); // 第一列宽度为100
3
ui->tableWidget->setColumnWidth(1, 150); // 第二列宽度为150
4
ui->tableWidget->setColumnWidth(2, 200); // 第三列宽度为200
5

6
//统一设置一样的列宽
7
ui->tableWidget->horizontalHeader()->setDefaultSectionSize(tmpform->width());//这里的tmpform是一个QWidget对象
8

9
//设置弹性布局（自动调整大小）
10
ui->tableWidget->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch);
11

12
// 根据内容调整
13
ui->tableWidget->resizeColumnsToContents();

注意：使用上面的设置表格所有行的默认高度为 tmpform 的宽度以及设置弹性布局（自动调整大小），需要添加头文件#include <QHeaderView>，否则会报错。

设置行高

1
// 设置表格的行高
2
ui->tableWidget->setRowHeight(0, 50); // 第一行高度为50
3
ui->tableWidget->setRowHeight(1, 70); // 第二行高度为70
4
ui->tableWidget->setRowHeight(2, 90); // 第三行高度为90
5

6
//统一设置一样的列宽
7
ui->tableWidget->horizontalHeader()->setDefaultSectionSize(tmpform->width());//这里的tmpform是一个QWidget对象
8

9
//设置弹性布局（自动调整大小）
10
ui->tableWidget->verticalHeader()->setSectionResizeMode(QHeaderView::Stretch);
11

12
// 根据内容调整
13
ui->tableWidget->resizeRowsToContents();

注意：使用上面的设置表格所有行的默认宽度为 tmpform 的宽度以及设置弹性布局（自动调整大小），需要添加头文件#include <QHeaderView>，否则会报错。

获取表格的行数和列数

1
// 获取表格的行数和列数
2
int rowCount = ui->tableWidget->rowCount();
3
int columnCount = ui->tableWidget->columnCount();

QSqlTableModel相关笔记：#

创建QSqlTableModel对象：

1
QSqlTableModel *model = new QSqlTableModel(this);

设置数据表名：

1
model->setTable("table_name");

设置编辑策略（重要！）

1
model->setEditStrategy(QSqlTableModel::OnManualSubmit);

QSqlTableModel有三种编辑策略：

OnFieldChange：所有更改立即提交到数据库（性能较差）
OnRowChange：当用户选择不同行时提交更改（默认策略）
OnManualSubmit：所有更改缓存起来，直到调用submitAll()（推荐用于复杂操作）

设置表头标签（可选）

1
model->setHeaderData(0, Qt::Horizontal, "姓名");
2
model->setHeaderData(1, Qt::Horizontal, "年龄");
3
model->setHeaderData(2, Qt::Horizontal, "性别");

提交数据：

1
model->submitAll();
2
// 获取详细错误信息
3
if (!model->submitAll()) {
4
    QSqlError error = model->lastError();
5
    qDebug() << "错误类型:" << error.type();
6
    qDebug() << "错误文本:" << error.text();
7
    qDebug() << "数据库错误:" << error.databaseText();
8
    qDebug() << "驱动错误:" << error.driverText();
9
    qDebug() << "错误代码:" << error.nativeErrorCode();
10
}

设置查询条件（相当于SQL的WHERE子句）：

1
model->setFilter("age > 20");

设置排序条件：

1
model->setSort(0, Qt::AscendingOrder); // 按第一列升序排序
2
model->setSort(2, Qt::DescendingOrder); // 按第二列降序排列

刷新数据：

1
model->select();

获取数据：

1
// 获取第一行第一列的数据
2
QVariant data = model->data(model->index(0, 0));

获取数据行数：

1
int rowCount = model->rowCount();

获取数据列数：

1
int columnCount = model->columnCount();

获取数据列名：

1
QString columnName = model->headerData(0, Qt::Horizontal).toString();

获取数据行名：

1
QString rowName = model->headerData(0, Qt::Vertical).toString();

获取数据类型：

1
QVariant::Type dataType = model->data(model->index(0, 0)).type();

修改数据示例：

1
// 修改第一行第一列的数据为"新值"
2
model->setData(model->index(0, 0), "新值");

删除数据列：

1
// 删除第一列
2
model->removeColumn(0);

添加数据列：

1
// 添加一列，列名设为"新列"
2
model->insertColumn(model->columnCount());
3
model->setHeaderData(model->columnCount() - 1, Qt::Horizontal, "新列");

删除数据行：

1
// 删除第一行
2
model->removeRow(0);
3

4
19. 直接数据访问方法：
5
```c++
6
// 方法1：使用record()访问数据[citation:1]
7
for (int i = 0; i < model->rowCount(); ++i) {
8
    QSqlRecord record = model->record(i);
9
    QString name = record.value("name").toString();
10
    int salary = record.value("salary").toInt();
11
    qDebug() << name << salary;
12
}
13

14
// 方法2：使用data()访问数据[citation:1]
15
for (int row = 0; row < model->rowCount(); ++row) {
16
    QString name = model->data(model->index(row, 1)).toString();
17
    int salary = model->data(model->index(row, 2)).toInt();
18
    qDebug() << name << salary;
19
}
20

21
// 更新数据示例[citation:1]
22
for (int i = 0; i < model->rowCount(); ++i) {
23
    QSqlRecord record = model->record(i);
24
    double salary = record.value("salary").toDouble();
25
    salary *= 1.1; // 涨薪10%
26
    record.setValue("salary", salary);
27
    model->setRecord(i, record);
28
}
29
model->submitAll();

事务处理（重要！）：

1
// 开始事务
2
QSqlDatabase::database().transaction();
3

4
// 执行多个操作...
5
model->setData(model->index(0, 0), "新值1");
6
model->setData(model->index(1, 0), "新值2");
7
bool success = model->submitAll();
8

9
// 根据结果提交或回滚
10
if (success) {
11
    QSqlDatabase::database().commit();
12
} else {
13
    QSqlDatabase::database().rollback();
14
    model->revertAll(); // 撤销所有更改
15
}

性能优化技巧：

1
// 批量操作前关闭自动排序
2
model->setSort(-1, Qt::AscendingOrder); // -1 表示不排序
3

4
// 批量操作完成后再设置排序
5
model->setSort(column, Qt::AscendingOrder);
6
model->select();
7

8
// 限制查询结果数量（大数据表）
9
model->setFilter("1=1 LIMIT 1000"); // 只获取前1000条记录

对于大量数据操作，使用OnManualSubmit策略
批量操作完成后一次性调用submitAll()
使用setFilter()和setSort()减少数据传输量

常用信号和槽：

1
// 数据更改前的信号
2
connect(model, &QSqlTableModel::beforeUpdate, [](int row, QSqlRecord &record) {
3
    qDebug() << "准备更新行:" << row;
4
});
5

6
// 数据插入前的信号
7
connect(model, &QSqlTableModel::beforeInsert, [](QSqlRecord &record) {
8
    qDebug() << "准备插入新记录";
9
});
10

11
// 数据删除前的信号
12
connect(model, &QSqlTableModel::beforeDelete, [](int row) {
13
    qDebug() << "准备删除行:" << row;
14
});
15

16
//  primeInsert 信号（用于设置默认值）
17
connect(model, &QSqlTableModel::primeInsert, [](int row, QSqlRecord &record) {
18
    record.setValue("create_time", QDateTime::currentDateTime());
19
    record.setValue("status", "active");
20
});

与QTableView配合使用：

1
// 设置模型到视图
2
QTableView *view = new QTableView;
3
view->setModel(model);
4

5
// 设置选择行为
6
view->setSelectionBehavior(QAbstractItemView::SelectRows); // 选择整行
7
view->setSelectionMode(QAbstractItemView::SingleSelection);  // 单选
8

9
// 隐藏不需要的列
10
view->hideColumn(0); // 通常隐藏ID列
11

12
// 设置列宽自适应
13
view->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch);

数据验证：

1
// 重写setData方法进行数据验证
2
class MySqlTableModel : public QSqlTableModel {
3
protected:
4
    bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override {
5
        if (index.column() == 1) { // 假设第二列是年龄
6
            int age = value.toInt();
7
            if (age < 0 || age > 150) {
8
                return false; // 拒绝无效数据
9
            }
10
        }
11
        return QSqlTableModel::setData(index, value, role);
12
    }
13
};

1
// 获取指定行列的数据
2
QVariant value = model->data(model->index(row, column));
3

4
// 获取指定行列的数据（带角色参数）
5
QVariant displayData = model->data(model->index(row, column), Qt::DisplayRole);
6

7
// 设置指定行列的数据
8
model->setData(model->index(row, column), value);
9

10
// 设置指定行列的数据（带角色参数）
11
model->setData(model->index(row, column), value, Qt::EditRole);
12

13
// 获取记录对象（包含该行所有字段）
14
QSqlRecord record = model->record(row);
15

16
// 获取字段值
17
QVariant fieldValue = record.value("fieldName");
18

19
// 设置字段值
20
record.setValue("fieldName", newValue);
21
model->setRecord(row, record);

推荐使用方式：

数据读取：使用 model->data(model->index(row, column)) - 最常用且高效
数据修改：使用 model->setData(model->index(row, column), value) - 简单直观
整行操作：使用 record() 和 setRecord() - 适合批量修改同一行的多个字段

QTabWidget相关笔记：#

QTableWidget相关笔记：#

QSqlTableModel相关笔记：#

评论区

目录