QSettings 类提供“持久性”,平台独立的应用程序设置。意思是,程序关闭后QSettings把窗体大小,位置,用户设置的Option 保存起来,下次打开程序时再重新加载。
如果你需要的是“非持久性” 基于内存的数据结构,可以考虑使用QMap<QString,QVariant> 代替。
通常,对于Windows,配置信息保存在“注册表”中,Mac OS 是XML 文件,Unix 是INI 文件
// 构造函数
QSettings settings("MySoft", "Star Runner"); // 公司或组织名 // 应用程序名
QCoreApplication::setOrganizationName("MySoft");
QCoreApplication::setOrganizationDomain("mysoft.com"); // 专为Mac OS X 准备的
QCoreApplication::setApplicationName("Star Runner");
...
QSettings settings;
如果要在程序很多地方使用QSettings,用 QCoreApplication::setOrganizationName() 和QCoreApplication::setApplicationName() 然后用QSettings 的默认构造函数。
这样,公司或组织名,应用程序名只要指定一次,QSettings settings 到处扔就行。
QSettings 存储了一对键值( Key / value ) ,Key 是一个QString,Value是一个QVariant
settings.setValue("editor/wrapMargin", 68); //添加一对键值
添加键值的时侯,如果Key 已存在,则Value 被重写。
出于效率的原因,setValue 不会立既写入(如注册表,INI, XML), 要立既写入可以用sync() 函数。
int margin = settings.value("editor/wrapMargin").toInt();
通过Key,取回Value。如果指定的Key 不存在,QSettings 返回空的QVariant(转成整型是 0)。
// 类型转换
QSettings settings("MySoft", "Star Runner");
QColor color =settings.value("DataPump/bgcolor").value<QColor>();
// 通过"/" 分组
settings.setValue("mainwindow/size",win->size());
settings.setValue("mainwindow/fullScreen",win->isFullScreen());
settings.setValue("outputpanel/visible",panel->isVisible());
settings.beginGroup("mainwindow");
settings.setValue("size", win->size());
settings.setValue("fullScreen",win->isFullScreen());
settings.endGroup();
settings.beginGroup("outputpanel");
settings.endGroup();
添加分组,并链表化,读写分组
void QSettings ::beginWriteArray ( const QString & prefix , int size = - 1 )Adds prefix to the current group and starts writing an array of size size.
If size is -1 (the default), it is automatically determined based on the indexes of the entries written.
If you have many occurrences of a certain set of keys,
you can use arrays to make your life easier.
For example, let's suppose that you want to save a variable-length list of user names and passwords.
You could then write:
struct Login{
QString userName;
QString password;
};
QList<Login> logins;
...
QSettings settings;
settings.beginWriteArray("logins");
for (int i = 0; i < logins.size(); ++i) {
settings.setArrayIndex(i);
settings.setValue("userName", list.at(i).userName);
settings.setValue("password", list.at(i).password);
}
settings.endArray();
int QSettings::beginReadArray(constQString&prefix)
Adds prefix to the current group and starts reading from an array. Returns the size of the array.
Example:
struct Login {
QString userName;
QString password;
};
QList<Login> logins;
...
QSettings settings;
int size = settings.beginReadArray("logins");
for (int i = 0; i < size; ++i) {
settings.setArrayIndex(i);
Login login;
login.userName = settings.value("userName").toString();
login.password = settings.value("password").toString();
logins.append(login);
}
settings.endArray();
Returns a list of all key top-level groups that contain keys that can be read using the QSettings object.
Example:
QSettings settings;
settings.setValue("fridge/color", Qt::white);
settings.setValue("fridge/size", QSize(32, 96));
settings.setValue("sofa", true);
settings.setValue("tv", false);
QStringList groups = settings.childGroups();
// groups: ["fridge"]
If a groupisset usingbeginGroup(),thefirst-levelkeysin that group are returned,withoutthegroup prefix.
settings.beginGroup("fridge");
groups = settings.childGroups();
// groups: []
You can navigate through the entire setting hierarchy using childKeys() and childGroups() recursively.
See also childKeys() and allKeys().
// readSettings() /writeSettings()
void MainWindow::writeSettings()
{
QSettings settings("Moose Soft", "Clipper");
settings.beginGroup("MainWindow");
settings.setValue("size", size());
settings.setValue("pos", pos());
settings.endGroup();
}
void MainWindow::readSettings()
{
QSettings settings("Moose Soft", "Clipper");
settings.beginGroup("MainWindow");
resize(settings.value("size", QSize(400, 400)).toSize());
move(settings.value("pos", QPoint(200, 200)).toPoint());
settings.endGroup();
}
// readSettings() and writeSettings() 必须分别位于主窗体的构造函数和closeEvent函数里面。
MainWindow::MainWindow()
{
...
readSettings();
}
void MainWindow::closeEvent(QCloseEvent*event)
{
if (userReallyWantsToQuit()) {
writeSettings();
event->accept();
} else {
event->ignore();
}
}
简单用例
main.cpp
#include <QtGui/QApplication>
#include "mainwindow.h"
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
MainWindow w;
w.show();
return a.exec();
}
mainwindow.h
#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QMainWindow>
namespace Ui {
class MainWindow;
}
class MainWindow : public QMainWindow
{
Q_OBJECT
public:
explicit MainWindow(QWidget *parent = 0);
~MainWindow();
private:
Ui::MainWindow *ui;
};
#endif // MAINWINDOW_H
mainwindow.cpp
#include "mainwindow.h"
#include "ui_mainwindow.h"
#include<QList>
#include<QSettings>
#include<QFile>
#include<QStringList>
#include<QDebug>
struct Login {
QString userName;
QString password;
};
MainWindow::MainWindow(QWidget *parent) :
QMainWindow(parent),
ui(new Ui::MainWindow)
{
ui->setupUi(this);
QList<Login> logins;
Login lg1[5];
for(int i=0;i<5;i++){
lg1[i].userName=QString("log%1").arg(i);
lg1[i].password="000";
logins<<lg1[i];
}
QString myfile="test.ini";
QSettings *settings=new QSettings(myfile,QSettings::IniFormat);
settings->beginWriteArray("logins1");//写数组logins1
for (int i = 0; i < logins.size(); ++i) {
settings->setArrayIndex(i);
settings->setValue("userName", logins.at(i).userName);
settings->setValue("password", logins.at(i).password);
}
QList<Login> logins2;
Login lg2[5];
for(int i=0;i<5;i++){
lg2[i].userName=QString("log%1").arg(i+5);
lg2[i].password="000";
logins2<<lg2[i];
}settings->endArray();
//QString myfile="test.txt";
//QSettings *settings=new QSettings(myfile,QSettings::IniFormat);
settings->beginWriteArray("logins2");//写数组logins2
for (int i = 5; i < logins2.size()+5; ++i) {
settings->setArrayIndex(i);
settings->setValue("userName", logins2.at(i-5).userName);
settings->setValue("password", logins2.at(i-5).password);
}
settings->endArray();
QStringList groups = settings->childGroups();
foreach(QString str,groups)//列出所有子组
qDebug()<<str;
//QSettings
int size = settings->beginReadArray("logins1");
for (int i = 0; i < size; ++i) {
settings->setArrayIndex(i);
Login login;
login.userName = settings->value("userName").toString();
login.password = settings->value("password").toString();
logins.append(login);
}
settings->endArray();
qDebug()<<logins.size();
for(int i=0;i<logins.size();i++)
{
qDebug()<<i<<logins[i].userName;
}
size = settings->beginReadArray("logins2");
for (int i = 0; i < size; ++i) {
settings->setArrayIndex(i);
Login login;
login.userName = settings->value("userName").toString();
login.password = settings->value("password").toString();
logins.append(login);
}
settings->endArray();
qDebug()<<logins.size();
for(int i=0;i<logins.size();i++)
{
qDebug()<<i<<logins[i].userName;
}
settings->beginWriteArray("maingroup");
//for (int i = 5; i < logins2.size()+5; ++i) {
settings->setValue("userName", "root");
settings->setValue("password", "000");
//}
settings->endArray();
qDebug()<<settings->value("maingroup/userName").toString();//列出maingroup下userName的值
}
MainWindow::~MainWindow()
{
delete ui;
}