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