QSettings之 beginGroup()、childKeys() 、value()

最新推荐文章于 2025-06-20 10:18:04 发布

原创最新推荐文章于 2025-06-20 10:18:04 发布 · 1w 阅读

30 ·

CC 4.0 BY-SA版权

QT 专栏收录该内容

6 篇文章

订阅专栏

本文详细介绍了Qt中的QSettings类，包括beginGroup()用于设置键名前缀的方法，childKeys()用于获取顶层键名列表的方法，以及value()用于读取键值的方法。通过示例展示了如何在实际项目中使用这些方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

QSettings之 beginGroup()、childKeys() 、value()

1. void QSettings:: beginGroup()

void QSettings::beginGroup(const QString & prefix)

Appends prefix to the current group.

给当前的group里由QSettings指定的所有键(key)，自动附上当前的group前缀。另外，一些查询函数例如childGroups(), childKeys(), allKeys() ，是基于group操作的。

对于路径相同的设置，使用group可以省去重复敲入路径名称的麻烦。例如：

settings.beginGroup("mainwindow");
settings.setValue("size", win->size());
settings.setValue("fullScreen", win->isFullScreen());
settings.endGroup();
 
settings.beginGroup("outputpanel");
settings.setValue("visible", panel->isVisible());
settings.endGroup();

上面代码会设置三组设置的值：

mainwindow/size

mainwindow/fullScreen

outputpanel/visible

组(groups)能够形成网络。调用beginGroup()后，需要调用endGroup(), 复位当前的组(group)。即：beginGroup()和endGroup()成套使用，否则会形成group网络。

2. QStringList QSettings:: childKeys() const

QStringList QSettings::childKeys() const

返回QSttings对象的所有顶层keys的一个列表。

例如：

QSettings settings;
settings.setValue("fridge/color", QColor(Qt::white));
settings.setValue("fridge/size", QSize(32, 96));
settings.setValue("sofa", true);
settings.setValue("tv", false);
QStringList keys = settings.childKeys();// keys: ["sofa", "tv"]

如果一个group用beginGroup()进行了group的设置，则返回的这个group里的顶层keys，不含group前缀。

settings.beginGroup("fridge");
keys = settings.childKeys();// keys: ["color", "size"]

通过递归调用childKeys() 和childGroups() ，可以遍历整个设置的各个层级。

3. Qvaiant Qsettings::value()

QVariant QSettings::value(const QString & key, const QVariant & defaultValue = QVariant()) const

返回键(key)的值。如果键不存在，返回默认值；如果没有指定默认值，返回默认的QVariant值。

注意：windows注册表和INI文件的键名(keys)，大小写不区分；而Mac OS X的Carbon Preference API的键名(keys)，区分大小写，也就是，大小写敏感。

例如：

QSettings settings;
settings.setValue("animal/snake", 58);
settings.value("animal/snake", 1024).toInt();   // returns 58
settings.value("animal/zebra", 1024).toInt();   // returns 1024
settings.value("animal/zebra").toInt();         // returns 0