Qt实用技巧：使用QTableView、QSqlTableMode与QSqlDatabase对数据库数据进行操作

2022-05-30 901

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： Qt实用技巧：使用QTableView、QSqlTableMode与QSqlDatabase对数据库数据进行操作

若该文为原创文章，未经允许不得转载

原博主博客地址：https://blog.csdn.net/qq21497936

原博主博客导航：https://blog.csdn.net/qq21497936/article/details/102478062

本文章博客地址：http://blog.csdn.net/qq21497936/article/details/78615800

各位读者，知识无穷而人力有穷，要么改需求，要么找专业人士，要么自己研究

红胖子(红模仿)的博文大全：开发技术集合（包含Qt实用技术、树莓派、三维、OpenCV、OpenGL、ffmpeg、OSG、单片机、软硬结合等等）持续更新中…（点击传送门）

Qt开发专栏：实用技巧（点击传送门）

需求

编写应用软件的过程中，需要对保存的数据进行动态的设置，当程序运行的时查询数据库获取相关配置项进行设置。

原理

使用时，将QSqlTableModel与QSqlDatabase绑定即model与sql绑定，然后将model与QTableView绑定，实现修改QTableView时，自动更新对数据库的操作，基本的数据库操作语句都省了。

Demo

Demo下载地址：http://download.csdn.net/download/qq21497936/10130238

Demo包含

图片.png

Demo截图

图片.png

关键代码

对于数据库的操作：打开数据库

    _db = QSqlDatabase::addDatabase("QSQLITE");
    _db.setDatabaseName("demo.db");
    // 数据库文件是否在应用程序目录下,因为在编码时,应用程序默认路径在.pro文件夹下，但是实际exe路径在的其debug或者release文件夹下
    // 补充：不论linux还是windows，统一使用单斜杠作为分隔，在linux和windows下都能识别，能更好的跨平台
#if 0
    // 发布时
    QString path = qApp->applicationDirPath()+"/"+"demo.db";
#else
    // 编译时
    QString path = qApp->applicationDirPath()+"/../"+"demo.db";
#endif
    if(QFile::exists(path))
    {
        // 存在则打开
        _db.open();
    }else{
        // 不存在打开并创建数据库表 补充：SQLite是基于文件的数据库，当打开时如果数据库文件不存在将自动创建一个
        _db.open();
        QSqlQuery query;
        // set为sqlite关键字，不能使用
        bool bRet = query.exec("create table init(" \
                               "no   INT    PRIMARY KEY NOT NULL,"\
                               "name TEXT   NOT NULL,"\
                               "content TEXT,"\
                               "description TEXT"\
                               ");");
        if(!bRet) {
            _db.close();
            QFile::remove(path);
        }else{
            // 此处演示了三种不同insert插入方法
            query.exec("insert into init values" \
                       "(1, '启动界面背景', 'images/background.jpg', '请使用1920*1080的图片，图片格式可以为png、jpg。');");
            query.exec("insert into init       " \
                       "(no,name,content,description) values(2, '欢迎视频', '','进入启动界面后，循环播放的视频,必须为mp4格式，如果为空则循环播放欢迎音乐');");
            query.exec("insert into init       " \
                       "(no,name,description) values (3, '欢迎音乐','进去启动界面后，循环播放的音频文件，可选择mp3,wav格式');");
        }
    }

QSqlTableMode与数据库绑定

    // 如果使用MySqlTableModel，重写了data，但是导致直接点击数据修改的时候，没有更新TableView，不知原因
    // 如果使用QSqlTableMode，则无法通过重载实现每一行自动居中等一些单元格的统一操作，只能遍历单元格设置
    QSqlTableModel *pModel = new QSqlTableModel(this, _db);
    pModel->setTable("init");
    // 三种提交方式，改动即提交，选择其他行时提交，手动提交；经实际测试，其中只有手动提交在显示效果上是最好的
    pModel->setEditStrategy(QSqlTableModel::OnManualSubmit);
    pModel->select();
    pModel->setHeaderData(0, Qt::Horizontal, "序号");
    pModel->setHeaderData(1, Qt::Horizontal, "名称");
    pModel->setHeaderData(2, Qt::Horizontal, "内容");
    pModel->setHeaderData(3, Qt::Horizontal, "描述");
    pModel->sort(0, Qt::AscendingOrder); // 第0列升序排序

QTableView与QSqlTableMode绑定

    ui->tableView->setModel(pModel);

QTableView的初始化设置

    // grid原本就是有多少格显示多少格，
//    ui->tableView->setShowGrid(false); // 可隐藏grid
    // 只能单选
    ui->tableView->setSelectionMode(QAbstractItemView::SingleSelection);
    // 以行作为选择标准
    ui->tableView->setSelectionBehavior(QAbstractItemView::QAbstractItemView::SelectRows);
    // 行头隐藏
    ui->tableView->verticalHeader()->hide();
    // 让列头可被点击，触发点击事件
    ui->tableView->horizontalHeader()->setSectionsClickable(true);
    // 去掉选中表格时，列头的文字高亮
    ui->tableView->horizontalHeader()->setHighlightSections(false);
    ui->tableView->horizontalHeader()->setBackgroundRole(QPalette::Background);
    // 列头灰色
    ui->tableView->horizontalHeader()->setStyleSheet("QHeaderView::section{background-color:rgb(225,225,225)};");
    connect(ui->tableView->horizontalHeader(), SIGNAL(sectionClicked(int)), this, SLOT(sortByColumn(int)));

QTableView点击列头的排序操作(初始化时，开启了列头clicked和关联信号槽)

void MainWindow::sortByColumn(int col)
{
    QSqlTableModel *pMode = dynamic_cast<QSqlTableModel *>(ui->tableView->model());
    bool ascending = (ui->tableView->horizontalHeader()->sortIndicatorSection()==col
                      && ui->tableView->horizontalHeader()->sortIndicatorOrder()==Qt::DescendingOrder);
    Qt::SortOrder order = ascending ? Qt::AscendingOrder : Qt::DescendingOrder;
    pMode->sort(col, order);
}

QTableView修改一行的保存操作

void MainWindow::on_pushButton_save_clicked()
{
    QSqlTableModel *pMode = dynamic_cast<QSqlTableModel *>(ui->tableView->model());
    pMode->database().transaction(); //开始事务操作
    if (pMode->submitAll()) // 提交所有被修改的数据到数据库中
    {
        pMode->database().commit(); //提交成功，事务将真正修改数据库数据
    } else {
        pMode->database().rollback(); //提交失败，事务回滚
        QMessageBox::warning(this, tr("tableModel"),tr("数据库错误: %1").arg(pMode->lastError().text()));
    }
    pMode->revertAll(); //撤销修改
}

QTableView新增一行的操作

void MainWindow::on_pushButton_add_clicked()
{
    QSqlTableModel *pMode = dynamic_cast<QSqlTableModel *>(ui->tableView->model());
//    pMode->insertRow(pMode->rowCount());
    QSqlRecord record = pMode->record();
    int number;
    // 从1开始遍历，遇到相同的，自增再遍历，直到没有相同的作为number插入
    // 防止唯一主键重复导致提交失败，因为提交失败tableview还是会更新修改后的（视图）
    for(number = 1; ; number++)
    {
        bool bFlag = false;
        for(int index = 0; index < pMode->rowCount(); index++) {
            if(pMode->index(index, 0).data().toInt() == number) {
                bFlag = true;
                break;
            }
        }
        if(!bFlag) {
            break;
        }
    }
    record.setValue(0, number);
    record.setValue(1, "未命令");
    record.setValue(2, "空");
    record.setValue(3, "空");
    pMode->insertRecord(pMode->rowCount(), record);
    // 每次手动提交，都会重新刷新tableView，保持mode和tableView一致
    pMode->submitAll();
}

QTableView删除一行的操作

void MainWindow::on_pushButton_del_clicked()
{
    QSqlTableModel *pMode = dynamic_cast<QSqlTableModel *>(ui->tableView->model());
    // 当QSqlTableModel::EditStrategy 选择 非QSqlTableModel::OnManualSubmit 时,
    // 每次删除都可删除掉model，但是tableview那一列为空，一直在，只好设置为 QSqlTableModel::OnManualSubmit
    pMode->removeRow(ui->tableView->currentIndex().row());
    // 每次手动提交，都会重新刷新tableView，保持mode和tableView一致
    pMode->submitAll();
}

拓展

整个应用，可只打开一次QSqlDatabase，程序中第一次使用了QDatabase，打开后不关闭且不再打开新的数据库，其他类中可直接声明QSqlDatabase对象db，然后使用QSqlQuery进行查询操作。（正常以为是需要传递，但Qt机制中，此处可不第二次打开，只要第一次不关闭，但是都必须在一个应用中）。

原博主博客地址：https://blog.csdn.net/qq21497936

原博主博客导航：https://blog.csdn.net/qq21497936/article/details/102478062

本文章博客地址：http://blog.csdn.net/qq21497936/article/details/78615800