#include <QSettings>

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

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

     settings.setValue("editor/wrapMargin", 68);

     int margin = settings.value("editor/wrapMargin").toInt();

     int margin = settings.value("editor/wrapMargin", 80).toInt();

 QSettings settings("MySoft", "Star Runner");
 QColor color = settings.value("DataPump/bgcolor").value<QColor>();

 QSettings settings("MySoft", "Star Runner");
 QColor color = palette().background().color();
 settings.setValue("DataPump/bgcolor", color);

     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.setValue("visible", panel->isVisible());
     settings.endGroup();

     QSettings obj1("MySoft", "Star Runner");
     QSettings obj2("MySoft");
     QSettings obj3(QSettings::SystemScope, "MySoft", "Star Runner");
     QSettings obj4(QSettings::SystemScope, "MySoft");

     QSettings settings(QSettings::IniFormat, QSettings::UserScope,
                        "MySoft", "Star Runner");

 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();
 }

 MainWindow::MainWindow()
 {
     ...
     readSettings();
 }

 void MainWindow::closeEvent(QCloseEvent *event)
 {
     if (userReallyWantsToQuit()) {
         writeSettings();
         event->accept();
     } else {
         event->ignore();
     }
 }

 QSettings settings("/home/petra/misc/myapp.ini",
                    QSettings::IniFormat);

 QSettings settings("/Users/petra/misc/myapp.plist",
                    QSettings::NativeFormat);

 QSettings settings("HKEY_CURRENT_USER\\Software\\Microsoft\\Office",
                    QSettings::NativeFormat);

 settings.setValue("11.0/Outlook/Security/DontTrustInstalledFiles", 0);

 settings.setValue("HKEY_CURRENT_USER\\MySoft\\Star Runner\\Galaxy", "Milkyway");
 settings.setValue("HKEY_CURRENT_USER\\MySoft\\Star Runner\\Galaxy\\Sun", "OurStar");
 settings.value("HKEY_CURRENT_USER\\MySoft\\Star Runner\\Galaxy\\Default"); // возвращает "Milkyway"

 bool myReadFunc(QIODevice &device, QSettings::SettingsMap &map);

 bool myWriteFunc(QIODevice &device, const QSettings::SettingsMap &map);

Описание функций-членов

QSettings::QSettings ( const QString & organization, const QString & application = QString(), QObject * parent = 0 )

Создаёт объект QSettings для доступа к настройкам приложения с названием application организации с названием organization и родителем parent.

Пример:

 QSettings settings("Moose Tech", "Facturo-Pro");

Область действия устанавливается в QSettings::UserScope, а формат - в QSettings::NativeFormat (т.е. вызов setDefaultFormat() перед вызовом этого конструктора не имеет никакого эффекта).

Смотрите также setDefaultFormat() и Механизм альтернативы.

QSettings::QSettings ( Scope scope, const QString & organization, const QString & application = QString(), QObject * parent = 0 )

Создаёт объект QSettings для доступа к настройкам приложения с названием application организации с названием organization и родителем parent.

Если область действия scope равна QSettings::UserScope, то объект QSettings вначале ищет пользовательские настройки, а затем, в качестве запасного варианта, - общесистемные настройки. Если scope равна QSettings::SystemScope, то объект QSettings игнорирует пользовательские настройки и предоставляет доступ к общесистемным настройкам.

Формат хранения устанавливается в QSettings::NativeFormat (т.е. вызов setDefaultFormat() перед вызовом этого конструктора не имеет никакого эффекта).

Если название приложения не задано, то объект QSettings предоставит доступ только к расположению организации.

Смотрите также setDefaultFormat().

QSettings::QSettings ( Format format, Scope scope, const QString & organization, const QString & application = QString(), QObject * parent = 0 )

Создаёт объект QSettings для доступа к настройкам приложения с названием application организации с названием organization и родителем parent.

Если область действия scope равна QSettings::UserScope, то объект QSettings вначале ищет пользовательские настройки, а затем, в качестве запасного варианта, - общесистемные настройки. Если scope равна QSettings::SystemScope, то объект QSettings игнорирует пользовательские настройки и предоставляет доступ к общесистемным настройкам.

Если формат format равен QSettings::NativeFormat, то для хранения настроек используется родной API. Если format равен QSettings::IniFormat, то используется формат INI.

Если название приложения не задано, то объект QSettings предоставит доступ только к расположению организации.

QSettings::QSettings ( const QString & fileName, Format format, QObject * parent = 0 )

Создаёт объект QSettings для доступа к настройкам, хранящимся в файле с именем fileName с родителем parent. Если файл ещё не существует, то он будет создан.

Если формат format равен QSettings::NativeFormat, то это означает, что имя файла fileName зависит от платформы. В Unix имя файла fileName является именем INI-файла. В Mac OS X fileName является именем файла .plist. В Windows fileName является путём в системном реестре.

Если формат format равен QSettings::IniFormat, то имя файла fileName является именем INI-файла.

Предупреждение: Эта функция предоставлена для удобства. Она хорошо работает при доступе к файлам INI или .plist, сгенерированных Qt, но может перестать работать на некоторых синтаксисах в таких файлах, созданных другими программами. В частности, следует учитывать следующие ограничения:

• QSettings не предоставляет возможности прочитать INI-записи "путей", т.е. записей с неэкранированными символами наклонной черты. (Это вызвано тем, что такие записи неоднозначны и неоднозначность не может быть разрешена автоматически.)
• В INI-файлах QSettings использует символ @ как метасимвол в некоторых контекстах для кодирования типов данных, специфичных для Qt (например, @Rect), и поэтому может неправильно истолковать его, когда оно встречается в чистых INI-файлах.

Смотрите также fileName().

QSettings::QSettings ( QObject * parent = 0 )

Создаёт объект QSettings для доступа к настройкам приложения и организации, установленных ранее вызовами QCoreApplication::setOrganizationName(), QCoreApplication::setOrganizationDomain() и QCoreApplication::setApplicationName().

Областью действия является QSettings::UserScope, а форматом - defaultFormat() (по умолчанию QSettings::NativeFormat). Используйте setDefaultFormat() перед вызовом этого конструктора для изменения формата по умолчанию, используемого этим конструктором.

Код

 QSettings settings("Moose Soft", "Facturo-Pro");

эквивалентен

 QCoreApplication::setOrganizationName("Moose Soft");
 QCoreApplication::setApplicationName("Facturo-Pro");
 QSettings settings;

Если QCoreApplication::setOrganizationName() и QCoreApplication::setApplicationName() не были предварительно вызваны, то объект QSettings будет не в состоянии читать или писать какие-либо настройки, а status() будет возвращать AccessError.

В Mac OS X, если для организации определены и имя, и Интернет-домен, то домен является более предпочтительным, чем имя. На других платформах имя является более предпочтительным, чем домен.

Смотрите также QCoreApplication::setOrganizationName(), QCoreApplication::setOrganizationDomain(), QCoreApplication::setApplicationName() и setDefaultFormat().

QSettings::~QSettings ()

Уничтожает объект QSettings.

Любые несохранённые изменения в конечном счёте будут записаны на место постоянного хранения.

Смотрите также sync().

QStringList QSettings::allKeys () const

Возвращает список всех ключей, включая подключи, которые могут быть прочитаны с помощью объекта QSettings.

Пример:

 QSettings settings;
 settings.setValue("fridge/color", Qt::white);
 settings.setValue("fridge/size", QSize(32, 96));
 settings.setValue("sofa", true);
 settings.setValue("tv", false);

 QStringList keys = settings.allKeys();
 // keys: ["fridge/color", "fridge/size", "sofa", "tv"]

Если с помощью beginGroup() установлена группа, то возвращаются только ключи в группе, без префикса группы:

 settings.beginGroup("fridge");
 keys = settings.allKeys();
 // keys: ["color", "size"]

Смотрите также childGroups() и childKeys().

QString QSettings::applicationName () const

Возвращает название приложения, используемое для хранения настроек.

Эта функция была введена в Qt 4.4.

Смотрите также QCoreApplication::applicationName(), format(), scope() и organizationName().

void QSettings::beginGroup ( const QString & prefix )

Добавляет префикс prefix к текущей группе.

Текущая группа автоматически добавляется в начало всех ключей, определяемых QSettings. Кроме того, функции запросов, такие как childGroups(), childKeys() и allKeys(), основываются на группе. По умолчанию группа не установлена.

Группы могут быть использованы для того, чтобы избежать ввода раз за разом одних и тех же путей настроек. Например:

 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

Вызовите endGroup() для сброса текущей группы к состоянию перед вызовом beginGroup(). Группы могут быть вложенными.

Смотрите также endGroup() и group().

int QSettings::beginReadArray ( const QString & prefix )

Добавляет префикс prefix к текущей группе и начинает читать из массива. Возвращает размер массива.

Пример:

 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();

Используйте beginWriteArray() для предварительной записи массива.

Смотрите также beginWriteArray(), endArray() и setArrayIndex().

void QSettings::beginWriteArray ( const QString & prefix, int size = -1 )

Добавляет префикс prefix к текущей группе и начинает запись массива размером size. Если размер size равен -1 (по умолчанию), то он определяется автоматически на основании индексов записываемых записей.

Если у вас есть множество вхождений определённого набора ключей, то вы можете упростить свою жизнь, используя массивы. Например, давайте предположим, что вы хотите сохранить массив имён пользователей и паролей переменной длины. Тогда вы можете написать:

 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();

Сгенерированные ключи будут иметь вид

• logins/size
• logins/1/userName
• logins/1/password
• logins/2/userName
• logins/2/password
• logins/3/userName
• logins/3/password
• ...

Чтобы считать массив обратно, используйте beginReadArray().

Смотрите также beginReadArray(), endArray() и setArrayIndex().

QStringList QSettings::childGroups () const

Возвращает список всех ключей групп верхнего уровня, содержащих ключи, которые могут быть прочитаны с помощью объекта QSettings.

Пример:

 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();
 // group: ["fridge"]

Если с помощью beginGroup() установлена группа, то возвращаются только ключи верхнего уровня в группе, без префикса группы.

 settings.beginGroup("fridge");
 groups = settings.childGroups();
 // groups: []

Вы можете также рекурсивно перемещаться через все иерархические настройки при помощи childKeys() и childGroups().

Смотрите также childKeys() и allKeys().

QStringList QSettings::childKeys () const

Возвращает список всех ключей верхнего уровня, которые могут быть прочитаны с помощью объекта QSettings.

Пример:

 QSettings settings;
 settings.setValue("fridge/color", Qt::white);
 settings.setValue("fridge/size", QSize(32, 96));
 settings.setValue("sofa", true);
 settings.setValue("tv", false);

 QStringList keys = settings.childKeys();
 // keys: ["sofa", "tv"]

Если с помощью beginGroup() установлена группа, то возвращаются только ключи верхнего уровня, без префикса группы:

 settings.beginGroup("fridge");
 keys = settings.childKeys();
 // keys: ["color", "size"]

Вы можете также рекурсивно перемещаться через все иерархические настройки при помощи childKeys() и childGroups().

Смотрите также childGroups() и allKeys().

void QSettings::clear ()

Удаляет все записи в основном расположении, связанном с объектом QSettings.

Записи в альтернативных расположениях не удаляются.

Если вы хотите удалить только записи в текущей группе group(), то используйте вместо этого remove("").

Смотрите также remove() и setFallbacksEnabled().

bool QSettings::contains ( const QString & key ) const

Возвращает true, если существует настройка с названием key; в противном случае возвращает false.

Если с помощью beginGroup() установлена группа, то ключ key берётся по отношению к этой группе.

Заметьте, что реестр Windows и INI-файлы используют нечувствительные к регистру ключи, в то время как Carbon Preferences API в Mac OS X использует чувствительные к регистру ключи. Чтобы избежать проблем с переносимостью, смотрите правила Синтаксиса разделов и ключей.

Смотрите также value() и setValue().

Format QSettings::defaultFormat () [static]

Возвращает формат файла по умолчанию, используемый для сохранения настроек в конструкторе QSettings(QObject *). Если формат по умолчанию не установлен, то используется QSettings::NativeFormat.

Эта функция была введена в Qt 4.4.

Смотрите также setDefaultFormat() и format().

void QSettings::endArray ()

Заканчивает массив, начатый при помощи beginReadArray() или beginWriteArray().

Смотрите также beginReadArray() и beginWriteArray().

void QSettings::endGroup ()

Сбрасывает группу к той, какой она была до соответствующего вызова beginGroup().

Пример:

 settings.beginGroup("alpha");
 // settings.group() == "alpha"

 settings.beginGroup("beta");
 // settings.group() == "alpha/beta"

 settings.endGroup();
 // settings.group() == "alpha"

 settings.endGroup();
 // settings.group() == ""

Смотрите также beginGroup() и group().

bool QSettings::event ( QEvent * event ) [virtual protected]

Переопределено от QObject::event().

bool QSettings::fallbacksEnabled () const

Возвращает true, если механизм альтернативы включён; в противном случае возвращает false.

По умолчанию механизм альтернативы включён.

Смотрите также setFallbacksEnabled().

QString QSettings::fileName () const

Возвращает путь, по которому сохраняются настройки, записываемые с помощью объекта QSettings.

В Windows, если формат равен QSettings::NativeFormat, возвращаемым значением является путь в системном реестре, не путь к файлу.

Смотрите также isWritable() и format().

Format QSettings::format () const

Возвращает формат, используемый для сохранения настроек.

Эта функция была введена в Qt 4.4.

Смотрите также defaultFormat(), fileName(), scope(), organizationName() и applicationName().

QString QSettings::group () const

Возвращает текущую группу.

Смотрите также beginGroup() и endGroup().

QTextCodec * QSettings::iniCodec () const

Возвращает кодек, который используется для доступа к файлам INI. По умолчанию кодек не используется, так что будет возвращён нулевой указатель.

Эта функция была введена в Qt 4.5.

Смотрите также setIniCodec().

bool QSettings::isWritable () const

Возвращает true, если настройки могут быть сохранены с помощью объекта QSettings; в противном случае возвращает false.

Одной из причин, почему isWritable() может вернуть false, является то, что QSettings работает с файлом только для чтения.

Предупреждение: Эта функция не является абсолютно надёжной, так как права доступа могут измениться в любой момент.

Смотрите также fileName(), status() и sync().

QString QSettings::organizationName () const

Возвращает название организации, используемой для хранения настроек.

Эта функция была введена в Qt 4.4.

Смотрите также QCoreApplication::organizationName(), format(), scope() и applicationName().

Format QSettings::registerFormat ( const QString & extension, ReadFunc readFunc, WriteFunc writeFunc, Qt::CaseSensitivity caseSensitivity = Qt::CaseSensitive ) [static]

Регистрирует пользовательский формат хранения. В случае успеха возвращает специальное значение Format, которое затем может быть передано в конструктор QSettings. В случае неудачи возвращает InvalidFormat.

extension - это расширение файла, связанное с форматом (без '.').

Параметры readFunc и writeFunc являются указателями на функции, которые читают и записывают набор пар ключ/значение. Параметр QIODevice в функциях чтения и записи всегда открывает в двоичном режиме (т.е. без флага QIODevice::Text).

Параметр caseSensitivity указывает, являются ли ключи чувствительными к регистру или нет. Это оказывает влияние на поиск значений с помощью QSettings. По умолчанию чувствительны к регистру.

По умолчанию, если вы используете один из конструкторов, которые работают с названием организации и названием приложения, то используются те же самые расположения в файловой системе, что и для IniFormat. Для указания другого размещения используйте setPath().

Пример:

 bool readXmlFile(QIODevice &device, QSettings::SettingsMap &map);
 bool writeXmlFile(QIODevice &device, const QSettings::SettingsMap &map);

 int main(int argc, char *argv[])
 {
     const QSettings::Format XmlFormat =
             QSettings::registerFormat("xml", readXmlFile, writeXmlFile);

     QSettings settings(XmlFormat, QSettings::UserScope, "MySoft",
                        "Star Runner");

     ...
 }

Замечание: Эта функция потокобезопасна.

Эта функция была введена в Qt 4.1.

Смотрите также setPath().

void QSettings::remove ( const QString & key )

Удаляет настройку key и любые вложенные в key настройки.

Пример:

 QSettings settings;
 settings.setValue("ape");
 settings.setValue("monkey", 1);
 settings.setValue("monkey/sea", 2);
 settings.setValue("monkey/doe", 4);

 settings.remove("monkey");
 QStringList keys = settings.allKeys();
 // keys: ["ape"]

Имейте в виду, что если в одном из альтернативных расположений содержится настройка с тем же ключом, то настройка будет видна после remove().

Если key является пустой строкой, то удаляются все ключи текущей группы group(). Например:

 QSettings settings;
 settings.setValue("ape");
 settings.setValue("monkey", 1);
 settings.setValue("monkey/sea", 2);
 settings.setValue("monkey/doe", 4);

 settings.beginGroup("monkey");
 settings.remove("");
 settings.endGroup();

 QStringList keys = settings.allKeys();
 // keys: ["ape"]

Заметьте, что реестр Windows и INI-файлы используют нечувствительные к регистру ключи, в то время как Carbon Preferences API в Mac OS X использует чувствительные к регистру ключи. Чтобы избежать проблем с переносимостью, смотрите правила Синтаксиса разделов и ключей.

Смотрите также setValue(), value() и contains().

Scope QSettings::scope () const

Возвращает область действия, используемую для сохранения настроек.

Эта функция была введена в Qt 4.4.

Смотрите также format(), organizationName() и applicationName().

void QSettings::setArrayIndex ( int i )

Устанавливает текущий индекс массива в i. Вызовы таких функций, как setValue(), value(), remove() и contains(), будут оперировать с записью массива с этим индексом.

Перед вызовом этой функции вы должны вызвать beginReadArray() или beginWriteArray().

void QSettings::setDefaultFormat ( Format format ) [static]

Устанавливает формат файла по умолчанию в заданный формат format, который используется для сохранения настроек в конструкторе QSettings(QObject *).

Если формат по умолчанию не установлен, то используется QSettings::NativeFormat. Смотрите документацию на используемый вами конструктор QSettings, чтобы увидеть, не проигнорирует ли конструктор эту функцию.

Эта функция была введена в Qt 4.4.

Смотрите также defaultFormat() и format().

void QSettings::setFallbacksEnabled ( bool b )

Устанавливает, включен ли механизм альтернативы, в b.

По умолчанию механизм альтернативы включён.

Смотрите также fallbacksEnabled().

void QSettings::setIniCodec ( QTextCodec * codec )

Устанавливает кодек для доступа к INI-файлам (включая файлы .conf в Unix) в codec. Кодек используется для декодирования любых данных, которые считываются из INI-файла, и кодирования любых данных, которые записываются в файл. По умолчанию кодек не используется, а не ASCII символы кодируются с помощью стандартных escape-последовательностей INI.

Предупреждение: Кодек должен быть установлен непосредственно после создания объекта QSettings, перед доступом к любым данным.

Эта функция была введена в Qt 4.5.

Смотрите также iniCodec().

void QSettings::setIniCodec ( const char * codecName )

Это перегруженная функция.

Устанавливает кодек для доступа к INI-файлам (включая файлы .conf в Unix) в QTextCodec для кодировки, заданной именем кодека codecName. Популярными значениями для codecName являются "ISO 8859-1", "UTF-8" и "UTF-16". Если кодировка не распознана, то ничего не происходит.

Эта функция была введена в Qt 4.5.

Смотрите также QTextCodec::codecForName().

void QSettings::setPath ( Format format, Scope scope, const QString & path ) [static]

Устанавливает путь, используемый для сохранения настроек, для заданных формата format и области действия scope в path. Формат format может быть пользовательским форматом.

В таблице ниже обобщены значения по умолчанию:

Платформа	Формат	Scope	Path
Windows	IniFormat	UserScope	%APPDATA%
		SystemScope	%COMMON_APPDATA%
Unix	NativeFormat, IniFormat	UserScope	$HOME/.config
		SystemScope	/etc/xdg
Qt для встраиваемых Linux-систем	NativeFormat, IniFormat	UserScope	$HOME/Settings
		SystemScope	/etc/xdg
Mac OS X	IniFormat	UserScope	$HOME/.config
		SystemScope	/etc/xdg

Пути UserScope по умолчанию в Unix и Mac OS X ($HOME/.config или $HOME/Settings) могут быть переопределены пользователем установкой переменной окружения XDG_CONFIG_HOME. Пути SystemScope по умолчанию в Unix и Mac OS X (/etc/xdg) могут быть переопределены при сборке библиотеки Qt при использовании с конфигурационным скриптом configure флага --sysconfdir (подробную информаци смотрите в QLibraryInfo).

Настройка путей NativeFormat в Windows и Mac OS X не имеет эффекта.

Предупреждение: Эта функция не влияет на существующие объекты QSettings.

Эта функция была введена в Qt 4.1.

Смотрите также registerFormat().

void QSettings::setValue ( const QString & key, const QVariant & value )

Устанавливает значение настройки key в значение value. Если key уже существует, то предыдущее значение перезаписывается.

Заметьте, что реестр Windows и INI-файлы используют нечувствительные к регистру ключи, в то время как Carbon Preferences API в Mac OS X использует чувствительные к регистру ключи. Чтобы избежать проблем с переносимостью, смотрите правила Синтаксиса разделов и ключей.

Пример:

 QSettings settings;
 settings.setValue("interval", 30);
 settings.value("interval").toInt();     // возвращает 30

 settings.setValue("interval", 6.55);
 settings.value("interval").toDouble();  // возвращает 6.55

Смотрите также value(), remove() и contains().

Status QSettings::status () const

Возвращает код состояния, указывающий первую ошибку, которая встретилась QSettings, или QSettings::NoError, если ошибок не было.

Помните, что QSettings откладывает выполнение некоторых операций. По этой причине перед вызовом status() вам может потребоваться вызвать sync() для гарантии того, что сохранённые в QSettings данные записаны на диск.

Смотрите также sync().

void QSettings::sync ()

Записывает любые несохранённые данные в постоянное хранилище и перезагружает любые настройки, которые были к тому времени изменены другим приложением.

Эта функция вызывается автоматически из деструктора QSettings и регулярно в цикле событий, так что вам обычно не требуется вызывать её самостоятельно.

Смотрите также status().

QVariant QSettings::value ( const QString & key, const QVariant & defaultValue = QVariant() ) const

Возвращает значение для настройки key. Если настройка не существует, то возвращает значение по умолчанию defaultValue.

Если значение по умолчанию не указано, то по умолчанию будет возвращён QVariant.

Заметьте, что реестр Windows и INI-файлы используют нечувствительные к регистру ключи, в то время как Carbon Preferences API в Mac OS X использует чувствительные к регистру ключи. Чтобы избежать проблем с переносимостью, смотрите правила Синтаксиса разделов и ключей.

Пример:

 QSettings settings;
 settings.setValue("animal/snake", 58);
 settings.value("animal/snake", 1024).toInt();   // возвращает 58
 settings.value("animal/zebra", 1024).toInt();   // возвращает 1024
 settings.value("animal/zebra").toInt();         // возвращает 0

Смотрите также setValue(), contains() и remove().