系列文章目录

---

---

前言

  在当今的应用程序开发中，设置管理是一个至关重要的方面。应用程序的设置包括用户偏好、配置选项和其他关键数据，这些数据需要被保存和恢复，以提供良好的用户体验。Qt框架提供了一个强大而灵活的类，称为QSettings，用于管理和存储应用程序的设置。

  QSettings类允许您以用户友好和跨平台的方式保存和访问应用程序的设置。它提供了一种简单的方式来读取和写入设置值，并且支持不同平台上的不同存储位置，如注册表、配置文件和INI文件。此外，QSettings还提供了一些高级特性，如监听设置的变化、使用默认值等，以满足各种设置管理需求。通过使用QSettings，我们可以轻松地访问和修改应用程序的设置，而不需要处理低级的I/O操作。

---

一、概述

1.1 QSetting是什么

QSetting是Qt框架中的一个类，用于管理和存储应用程序的设置。它可以方便地读取和写入应用程序的配置值，包括字符串、整数、浮点数、布尔值和QVariant类型等。QSetting支持将配置值存储在操作系统的注册表中（Windows系统）或INI文件中（其他操作系统），也可以使用自定义格式进行存储。应用程序可以使用QSetting类来保持用户首选项、应用程序状态和其他需要持久化的数据。

1.2 为什么学习QSetting是重要的

学习QSetting是重要的，因为它可以帮助开发者管理和存储应用程序的设置，包括用户首选项、应用程序状态和其他需要持久化的数据。以下是学习QSetting的重要原因：

• 简单易用： QSetting提供了简单易用的API，使开发者能够方便地读取和写入设置值，无论是保存在注册表、INI文件还是其他自定义格式中。

• 跨平台性： QSetting在不同平台（Windows、Linux、Mac等）上都有良好的支持。它能够自动选择合适的存储位置和格式，使开发者无需关心底层细节。

• 持久化数据： QSetting可以帮助开发者将数据持久化保存，使得应用程序在重新启动后能够恢复到上次的状态或用户设置。

• 用户首选项： 通过QSetting，开发者可以轻松管理和存储用户的首选项，如语言、主题、字体设置等。这样，用户在下一次打开应用程序时，可以自动恢复他们的首选项。

• 数据共享： 通过QSetting，开发者可以将数据存储在共享位置，使不同的应用程序之间可以访问和共享这些数据，提供更好的用户体验和一致性。

二、不同存储位置的优缺点

不同存储位置的优缺点如下：

1. 注册表：

   • 优点：
     • 注册表是Windows操作系统的一部分，可用于存储应用程序的设置值。
     • 注册表的访问速度较快，可以在系统级别共享设置值。
   • 缺点：
     • 注册表是操作系统的核心部分，需要管理员权限才能访问和更改。
     • 注册表的结构复杂，不方便直接编辑。

2. 配置文件：

   • 优点：
     • 配置文件通常是文本文件，易于编辑和维护。
     • 配置文件可以存储在应用程序的安装目录中，使其易于分发和更新。
   • 缺点：
     • 配置文件可能需要手动创建和维护。
     • 配置文件通常是明文存储，可能存在安全风险。

3. INI文件：

   • 优点：
     • INI文件是简单且通用的配置文件格式，易于使用和理解。
     • INI文件可以按部分和键值对的结构存储设置值。
   • 缺点：
     • INI文件不支持嵌套结构和复杂的数据类型。
     • INI文件在处理大量设置值时性能可能较低。

三、 QSetting的高级用法

QSettings提供了一些高级特性，使设置值的使用更加灵活和方便。以下是一些常用的高级特性：

1. 监听设置的变化：可以使用QSettings的valueChanged信号来监听设置值的变化。当设置值发生变化时，会触发该信号，可以在相应的槽函数中处理变化。

QObject::connect(&settings, &QSettings::valueChanged, [](const QString& key, const QVariant& value) {
    qDebug() << "Setting" << key << "changed to" << value.toString();
});

2. 使用默认值：可以通过value方法的第二个参数设置默认值。当读取的设置值不存在时，将返回设置的默认值。

QString username = settings.value("username", "defaultUsername").toString();

3. 设置默认值：可以使用setDefault方法来设置默认值，该默认值将在读取设置值时使用。

settings.setDefault("username", "defaultUsername");

4. 删除设置值：可以使用remove方法来删除指定的设置值。

settings.remove("username");

5. 清除所有设置值：可以使用clear方法来清除所有的设置值。

settings.clear();

6. 同步设置值：默认情况下，QSettings会在每次设置值时自动同步到底层存储位置。但是，可以通过sync方法来强制手动同步设置值。

settings.sync();

四、实例演示

示例1：

    QSettings settings("参数.ini",QSettings::IniFormat);
    settings.setIniCodec(QTextCodec::codecForName("utf-8"));

    //!写
    //![0]
    settings.setValue("register/acount"  ,"夯大力" );
    settings.setValue("register/password","123456");

    //![1]
    settings.beginGroup("register");
    settings.setValue("acount"  ,"夯大力");
    settings.setValue("password","12345");
    settings.endGroup();

    //![2]
    settings.beginWriteArray("register");
    for(int i = 0;i < 3;i++)
    {
        settings.setArrayIndex(i);
        settings.setValue("acount"  ,"夯大力");
        settings.setValue("password","12345");
    }
    settings.endArray();


    settings.sync();

    //!读
    //![0]
    qDebug().noquote() << settings.value("register/acount").toString() << "|"\
                       << settings.value("register/password").toString();
    qDebug().noquote() << settings.value("register/acount").toString() << "|"\
                       << settings.value("register/password").toString();
    //![1]
    QStringList list = settings.allKeys();
    for(int i = 0;i < list.size();i++)
    {
        qDebug() << "key:" << list.at(i) << "|" << "value:" \
                 << settings.value(list.at(i)).toString();
    }

运行结果：

注意：

• QSettings在写float类型时要将float强制转化为double类型，写入文件才能正常显示。
• 中文字符键值在保存的文档中不能正常显示

---

总结

QSetting是一个用于存储和管理应用程序设置的类。它提供了一种方便的方式来存储和获取应用程序的配置信息。

QSetting的主要概念包括：

1. 键-值对：QSetting使用键-值对的形式来存储数据。每个设置项都有一个唯一的键和一个与之关联的值。
2. 组：QSetting允许将设置项分组，以便更好地组织和管理设置。每个组都有一个唯一的名称。
3. 作用域：QSetting支持全局和本地两种作用域。全局作用域的设置项在整个系统范围内有效，而本地作用域的设置项只在当前应用程序中有效。
4. 默认值：QSetting允许为设置项设置默认值。当没有为设置项指定值时，将使用默认值。

QSetting的用法主要包括：

1. 创建QSetting实例：可以通过指定作用域和组名称来创建一个QSetting实例。
2. 存储设置项：可以使用setValue()方法将设置项的值存储在QSetting中。可以指定键和值，以及可选的组和作用域。
3. 获取设置项：可以使用value()方法从QSetting中获取设置项的值。可以指定键、默认值和可选的组和作用域。
4. 删除设置项：可以使用remove()方法从QSetting中删除设置项。
5. 检查设置项是否存在：可以使用contains()方法来检查给定键的设置项是否存在。
6. 获取所有设置项：可以使用allKeys()方法获取所有设置项的键。