Qt QSetting配置管理

QSetting 配置管理

QSetting是Qt框架中用于管理应用程序配置和设置的类。它提供了一种简单的方式来存储和检索应用程序的设置，通常用于保存用户偏好、窗口位置、最近打开的文件等信息。

主要功能#

• 跨平台支持： QSetting在不同操作系统上使用不同的后端存储：
  • Windows：使用注册表
  • macOS：使用属性列表文件(plist)。
  • Linux/Unix：使用INI文件。
• 简单的键值对存储：QSetting使用键值对的方式存储数据，键是字符串，值可以是QVariant支持的任何类型(如int、QString、QColor等)。
• 分组支持：可以通过beginGroup()和endGroup()方法来组织设置，类似于文件系统中的目录结构。
• 自动保存：在QSetting对象销毁时会自动将数据写入存储介质，也可以通过sync()方法手动写入。

基本用法#

创建QSetting对象#

1. 通过组织名称和应用程序名称来初始化 —— 默认存储方式（Windows使用注册表存储）

Copy
// 使用应用程序名称和组织名称初始化 QSettings
QSettings settings("MyCompany", "MyApp");

2. 通过指定存储格式（如ini文件）和文件路径

   在指定存储格式的方式下，在Windows平台下不会使用注册表来存储。

   如果文件不存在会自动创建

Copy
// 或者指定存储格式和文件路径
QSettings settings("/path/to/settings.ini", QSettings::IniFormat);

写入设置#

通过setValue()以键值对的形式写入设置，键必须为字符串类型

Copy
settings.setValue("size", QSize(800, 600));
settings.setValue("position", QPoint(100, 100));
settings.setValue("recentFiles", QStringList() << "file1.txt" << "file2.txt");

分组管理#

通过beginGroup()来开启分组，通过endGroup()结束分组，分组中的子项访问通过"/"链接来访问对应的键值对，如"window/size"。

Copy
settings.beginGroup("window");
settings.setValue("size", QSize(800, 600));
settings.setValue("position", QPoint(100, 100));
settings.endGroup();

读取设置#

通过value(键，值)来访问对应的设置

Copy
QSize size = settings.value("window/size", QSize(400, 300)).toSize();
QPoint pos = settings.value("window/position", QPoint(50, 50)).toPoint();
QStringList recentFiles = settings.value("recentFiles").toStringList();

删除设置#

通过remove(键)删除对应的设置

Copy
settings.remove("window/size");  // 删除单个键
settings.remove("window");       // 删除整个分组

同步设置#

sync()可以控制手动写入存储介质即Windows写入注册表

Copy
settings.sync();  // 手动将设置写入存储介质

高级用法#

默认值#

在读取设置时，可以提供一个默认值。当键不存在时，QSetting将返回这个默认值。

Copy
QString theme = settings.value("theme", "default").toString();

枚举所有键#

通过allKeys()可以获取到所有键的列表

Copy
QStringList keys = settings.allKeys();
for (const QString &key : keys) {
    qDebug() << key << ":" << settings.value(key);
}

检查键是否存在#

Copy
if (settings.contains("window/size")) {
    // 键存在
}

清除所有设置#

Copy
settings.clear();

注意事项#

• 非线程安全：QSetting不是线程安全的，如果需要在多线程环境中使用，需要额外的同步机制。
• 性能：频繁的读写操作可能会影响性能，尤其是Windows上使用注册表时，建议将多个设置合并为一次写入操作。

使用QSetting完成程序开机自启#

"HKEY_CURRENT_USER\\Software\\Microsoft\\Windows\\CurrentVersion\\Run"是注册表中的路径，表示当前用户的启动项。在这个路径下，Windows 会查找用户登录时需要自动启动的程序。

Copy
// 通过注册表路径设置开机自启
QSettings settings("HKEY_CURRENT_USER\\Software\\Microsoft\\Windows\\CurrentVersion\\Run", QSettings::NativeFormat);
settings.setValue("autoLoginQatarApp", QCoreApplication::applicationFilePath().replace('/', '\\'));

QSettings::NativeFormat用于指示 QSettings 使用操作系统的原生方式来存储配置数据