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

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