简介
QSettings类提供了持久的跨平台应用程序设置。
用户通常期望应用程序记住它的设置(窗口大小、位置等)所有会话。这些信息通常存储在Windows系统注册表,OS X和iOS的属性列表文件中。在Unix系统中,在缺乏标准的情况下,许多应用程序(包括KDE应用程序)使用INI文本文件。
QSettings围绕这些抽象技术,使我们能够以便携的方式保存和恢复应用程序设置。它还支持自定义存储格式。
QSettings API基于QVariant,可以保存很多基础的类型,比如 QString、QRect、QImage等。
如果你需要的是一个非持久性的基于内存结构,可以考虑使用QMap<QString, QVariant>
代替。
基本用法
当创建一个QSettings对象时,必须通过指定公司或组织名称以及产品名称,例如:公司名称为:MySoft,产品名为:Star Runner,那么可以用下列方式来构造QSettings对象:
QSettings settings("MySoft", "Star Runner");
QSettings对象既可以创建在栈上,也可以创建在堆(即使用new)上,构建和销毁也非常快。
如果你的应用程序在很多地方使用QSettings,则可以使用QCoreApplication::setOrganizationName()
和 QCoreApplication::setApplicationName()
来指定组织名和应用名,然后使用默认的QSettings构造函数:
QCoreApplication::setOrganizationName("MySoft");
QCoreApplication::setOrganizationDomain("mysoft.com");
QCoreApplication::setApplicationName("Star Runner");
...
QSettings settings;
QSettings可以存储一系列设置。每个设置包括指定设置名称(键)的一个字符串和一个与该键关联的QVariant存储数据。使用setValue()可以实现一个设置。例如:
settings.setValue("editor/wrapMargin", 68);
如果存在相同的设置键,现有的值将被新值覆盖。为了提高效率,这些变化可能不会被立即保存到永久存储(可以随时调用sync()来提交更改)。
可以使用value()得到一个设置的值:
int margin = settings.value("editor/wrapMargin").toInt();
如果没有指定键对应的设置,QSettings将会返回一个空QVariant(可转换为整数0)。这时,我们可以通过另一个参数来指定默认值:
int margin = settings.value("editor/wrapMargin", 80).toInt();
- contains() 判断一个指定的键是否存在
- remove() 删除相关的键
- allKeys() 获取所有键
- clear() 删除所有键
void QSettings::beginGroup(const QString & prefix)
为当前组附加前缀。
当前组会自动追加到指定QSettings所有键。此外,查询功能,如childGroups()、childKeys()、allKeys() 也是基于组的。默认情况下,不存在组设置。
组是有用的,以避免输入同样的设置路径。例如:
settings.beginGroup("mainwindow");
settings.setValue("size", win->size());
settings.setValue("fullScreen", win->isFullScreen());
settings.endGroup();
settings.beginGroup("outputpanel")