Qt之QSettings类保存和读取应用程序配置信息

简介

有时候我们会期望应用程序记住一些设置或配置信息，比如说窗口大小、位置或者上一次打开的文件等等。在windows操作系统中这些信息一般保存在系统注册表里，在macOS、IOS中则保存在一个属性列表文件里，而Unix系统没有统一的标准，大多数应用程序（包括KDE应用）都保存在INI文件中。

Qt提供了一个独立于平台的可以保存和恢复应用程序设置的类QSettings。

基本用法

1、构造

首先我们必须创建一个QSetting对象，在你构造该类的时候你需要传递相应的公司或组织抑或是你的应用程序的名字，如下：

QSettings settings("MySoft", "Star Runner");

也可以这样：

QSettings settings(QCoreApplication::organizationName(), QCoreApplication::applicationName());

当然如果你的应用程序有多个地方使用该类，那么建议你使用如下方式：

QCoreApplication::setOrganizationName("MySoft");
QCoreApplication::setOrganizationDomain("mysoft.com");
QCoreApplication::setApplicationName("Star Runner");

/* 直接使用默认构造函数 */
QSettings settings;

注意上述代码中指定Internet domain语句，当其被设置时，在macOS和IOS系统中将被使用而不是organization name，因为macOS和IOS应用程序使用Internet domain来识别自己。

2、写配置

QSettings类以(key, value)形式来保存配置，每一个配置信息包含一个QString指定的key和由QVariant所存储的和key对应的数据，使用setValue()可以写入设置。如下：

#define WINSIZE      "windowSize"
#define NUMOFRESLAB  "NumOfResLabels"

int fileCount = 5;			// 假设这是我们的应用程序打开的文件数
QStringList fileList;       // 假设这里面存储着打开的文件的绝对路径名 
QSettings settings;         // 这里我们使用默认构造函数 

// 保存窗口尺寸以及位置
settings.beginGroup(WINSIZE);
settings.setValue("pos", QVariant(pos()));
settings.setValue("size", QVariant(size()));
settings.endGroup();

// 保存打开的文件数以及文件
settings.beginGroup(NUMOFRESLAB);
settings.setValue("labelofnumber", QVariant(fileCount));
settings.setValue("fileNameList", QVariant(fileList));
settings.endGroup();

上述代码中beginGroup()的作用添加指定的前缀给QSetting，这种方法可以避免两个相同的key互相覆盖，endGroup()作用是退出当前Group，Group也可以是嵌套的。上述代码所生成的设置如下：

windowSize/pos
windowSize/size
NumOfResLabels/labelofnumber
NumOfResLabels/fileNameList

3、读配置信息

使用value()我们可以得到相应的key值，如下代码可以获取步骤2中写入的配置信息：

#define WINSIZE      "windowSize"
#define NUMOFRESLAB  "NumOfResLabels"

QSettings settings;
int Dwidth  = QApplication::desktop()->width();
int Dheight = QApplication::desktop()->height();

QPoint pos = settings.value("pos", QPoint(int(Dwidth * 0.2),int(Dheight * 0.1))).toPoint();
QSize size = settings.value("size", QSize(int(Dwidth * 0.6), int(Dheight * 0.75))).toSize();

// 读取窗口的尺寸以及位置
settings.beginGroup(WINSIZE);
if (settings.contains("pos") && settings.contains("size")) {
	pos = settings.value("pos").toPoint();
	size = settings.value("size").toSize();
}
move(pos);
resize(size);
settings.endGroup();

// 读取打开的文件数以及文件
settings.beginGroup(NUMOFRESLAB);
int count = settings.value("labelofnumber").toInt();
if (count != 0) {
	QStringList fileList = settings.value("fileNameList").toStringList();
	QStringList::const_iterator constIterator;
	for (constIterator = fileList.constBegin(); constIterator != fileList.constEnd(); ++constIterator) {
		cout << (*constIterator).toLocal8Bit().constData()) << endl;
	}
}
settings.endGroup();