Qt 快速保存配置的方法

news2025/10/31 14:51:09

Qt 快速保存配置的方法

一、概述
二、代码
- 1. QFileHelper.cpp
- 2. QSettingHelper.cpp
三、使用

一、概述

这里分享一下，Qt界面开发时，快速保存界面上一些参数配置的方法。

因为我在做实验的时候，界面上可能涉及到很多参数的配置，我也不大可能自己去记录每一个参数的值，不保存这些，下次启动的时候要自己手输就非常浪费时间，因此我用了Qt的Meta-Object 系统，结合了ObjectName，把配置保存为json文本。这就非常方便的实现了我想要的功能。

为了改动不大，为了避免配置耦合，还是采用分离的宏定义的方式去做会更好一些。暂时没有想到用类的继承去做，有建议的话可以在评论区交流一下呐。

二、代码

1. QFileHelper.cpp

这个函数就是保存和读写文本的通用配置，在写文件的时候，不存在目录的文件也会先创建目录文件的父目录再去写。

bool QFileHelper::writeAllText(const QString &fileName, QString &text)
{
    QFile file(fileName);
    QDir dir(fileName);

    QString parentPath = dir.absolutePath().replace(dir.absolutePath().split("/", QString::SkipEmptyParts).last(), "");

    if(!dir.exists(parentPath)){
        if(!dir.mkdir(parentPath)){
            return false;
        }
    }
    if (!file.open(QIODevice::WriteOnly | QIODevice::Text))
        return false;

    QTextStream in(&file);
    in.setCodec("utf-8");

    in<<text;

    QSettingHelper::Instance()->setLastOpenFileDir(QFileInfo(fileName).dir().absolutePath());

    file.close();
    return true;
}

bool QFileHelper::readAllText(const QString &fileName, QString &text)
{
    QFile file(fileName);
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text))
        return false;

    QTextStream in(&file);
    in.setCodec("utf-8");

    text = in.readAll();

    QSettingHelper::Instance()->setLastOpenFileDir(QFileInfo(fileName).dir().absolutePath());

    file.close();
    return true;
}

2. QSettingHelper.cpp

定义了保存、加载配置的宏，配置文件我是放在当前应用程序的/config/源文件结构.config

每一个文件用了这个宏都会根据源文件名（包含路径）去保存里面的QSPBox、QDoubleSPbox的值。

下面目前没有保存 QLineEdit的值，但是可以继续扩展。

#include <common/QFileHelper.h>
#include <QJsonDocument>
#include <QJsonObject>
#include <QCoreApplication>
#include <QSpinBox>
#include <QDoubleSpinBox>

#define LOADCONFIG() \
{\
    QString json;\
    QString fileName = QCoreApplication::applicationDirPath() + "/configs/" + QString(__FILE__).split(".")[0] + ".config";\
    if(QFileHelper::readAllText(fileName, json )){\
        QJsonDocument jsDoc  = QJsonDocument::fromJson(json.toUtf8());\
        QJsonObject jsObj = jsDoc.object();\
        QDoubleSpinBox * d_spbox = nullptr;\
        QSpinBox * spbox = nullptr;\
        for(auto it : jsObj.keys()){\
            QObject * obj = this->findChild<QObject *>(it);\
            if(!obj) continue;\
            if(d_spbox = qobject_cast<QDoubleSpinBox*>(obj)){\
                d_spbox->setValue(jsObj.value(d_spbox->objectName()).toDouble());\
            }\
            if(spbox = qobject_cast<QSpinBox*>(obj)){\
                spbox->setValue(jsObj.value(spbox->objectName()).toInt());\
            }\
        }\
    }\
}

#define SAVECONFIG() \
{\
    QString fileName = QCoreApplication::applicationDirPath() + "/configs/" + QString(__FILE__).split(".")[0] + ".config";\
    QList<QSpinBox *> spbox_list = this->findChildren<QSpinBox *>();\
    QList<QDoubleSpinBox *> double_spbox_list = this->findChildren<QDoubleSpinBox *>();\
    QJsonObject jsObj;\
    for(auto it : spbox_list ){\
        jsObj.insert(it->objectName(), it->value());\
    }\
    for(auto it : double_spbox_list){\
        jsObj.insert(it->objectName(), it->value());\
    }\
    QJsonDocument jsDoc(jsObj);\
    QString json =  jsDoc.toJson();\
    if(QFileHelper::writeAllText(fileName,  json)){\
    }else{\
    }\
}

三、使用

因为我只是在构造和析构的时候用了，当然你可以自己定时去保存都可以。

ShapeDetectionWG::ShapeDetectionWG(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::ShapeDetectionWG)
{
    ui->setupUi(this);

    ui->tableWidget->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch);

    qRegisterMetaType<Surface_mesh>("Surface_mesh&");
		
	//构造函数加载配置
    LOADCONFIG();
}

ShapeDetectionWG::~ShapeDetectionWG()
{
	//析构前保存配置
    SAVECONFIG();
    
    delete ui;
}