<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- qsettings.cpp --> <title>Qt 4.8: Qt 3 Support Members for QSettings</title> <link rel="stylesheet" type="text/css" href="style/style.css" /> <script src="scripts/jquery.js" type="text/javascript"></script> <script src="scripts/functions.js" type="text/javascript"></script> <link rel="stylesheet" type="text/css" href="style/superfish.css" /> <link rel="stylesheet" type="text/css" href="style/narrow.css" /> <!--[if IE]> <meta name="MSSmartTagsPreventParsing" content="true"> <meta http-equiv="imagetoolbar" content="no"> <![endif]--> <!--[if lt IE 7]> <link rel="stylesheet" type="text/css" href="style/style_ie6.css"> <![endif]--> <!--[if IE 7]> <link rel="stylesheet" type="text/css" href="style/style_ie7.css"> <![endif]--> <!--[if IE 8]> <link rel="stylesheet" type="text/css" href="style/style_ie8.css"> <![endif]--> <script src="scripts/superfish.js" type="text/javascript"></script> <script src="scripts/narrow.js" type="text/javascript"></script> </head> <body class="" onload="CheckEmptyAndLoadList();"> <div class="header" id="qtdocheader"> <div class="content"> <div id="nav-logo"> <a href="index.html">Home</a></div> <a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a> <div id="narrowsearch"></div> <div id="nav-topright"> <ul> <li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li> <li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li> <li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/"> DOC</a></li> <li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li> </ul> </div> <div id="shortCut"> <ul> <li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li> <li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li> </ul> </div> <ul class="sf-menu" id="narrowmenu"> <li><a href="#">API Lookup</a> <ul> <li><a href="classes.html">Class index</a></li> <li><a href="functions.html">Function index</a></li> <li><a href="modules.html">Modules</a></li> <li><a href="namespaces.html">Namespaces</a></li> <li><a href="qtglobal.html">Global Declarations</a></li> <li><a href="qdeclarativeelements.html">QML elements</a></li> </ul> </li> <li><a href="#">Qt Topics</a> <ul> <li><a href="qt-basic-concepts.html">Programming with Qt</a></li> <li><a href="qtquick.html">Device UIs & Qt Quick</a></li> <li><a href="qt-gui-concepts.html">UI Design with Qt</a></li> <li><a href="supported-platforms.html">Supported Platforms</a></li> <li><a href="technology-apis.html">Qt and Key Technologies</a></li> <li><a href="best-practices.html">How-To's and Best Practices</a></li> </ul> </li> <li><a href="#">Examples</a> <ul> <li><a href="all-examples.html">Examples</a></li> <li><a href="tutorials.html">Tutorials</a></li> <li><a href="demos.html">Demos</a></li> <li><a href="qdeclarativeexamples.html">QML Examples</a></li> </ul> </li> </ul> </div> </div> <div class="wrapper"> <div class="hd"> <span></span> </div> <div class="bd group"> <div class="sidebar"> <div class="searchlabel"> Search index:</div> <div class="search" id="sidebarsearch"> <form id="qtdocsearch" action="" onsubmit="return false;"> <fieldset> <input type="text" name="searchstring" id="pageType" value="" /> <div id="resultdialog"> <a href="#" id="resultclose">Close</a> <p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p> <p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p> <ul id="resultlist" class="all"> </ul> </div> </fieldset> </form> </div> <div class="box first bottombar" id="lookup"> <h2 title="API Lookup"><span></span> API Lookup</h2> <div id="list001" class="list"> <ul id="ul001" > <li class="defaultLink"><a href="classes.html">Class index</a></li> <li class="defaultLink"><a href="functions.html">Function index</a></li> <li class="defaultLink"><a href="modules.html">Modules</a></li> <li class="defaultLink"><a href="namespaces.html">Namespaces</a></li> <li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li> <li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li> </ul> </div> </div> <div class="box bottombar" id="topics"> <h2 title="Qt Topics"><span></span> Qt Topics</h2> <div id="list002" class="list"> <ul id="ul002" > <li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li> <li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li> <li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li> <li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li> <li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li> <li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li> </ul> </div> </div> <div class="box" id="examples"> <h2 title="Examples"><span></span> Examples</h2> <div id="list003" class="list"> <ul id="ul003"> <li class="defaultLink"><a href="all-examples.html">Examples</a></li> <li class="defaultLink"><a href="tutorials.html">Tutorials</a></li> <li class="defaultLink"><a href="demos.html">Demos</a></li> <li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li> </ul> </div> </div> </div> <div class="wrap"> <div class="toolbar"> <div class="breadcrumb toolblock"> <ul> <li class="first"><a href="index.html">Home</a></li> <!-- Breadcrumbs go here --> <li><a href="modules.html">Modules</a></li> <li><a href="qtcore.html">QtCore</a></li> <li>QSettings</li> </ul> </div> <div class="toolbuttons toolblock"> <ul> <li id="smallA" class="t_button">A</li> <li id="medA" class="t_button active">A</li> <li id="bigA" class="t_button">A</li> <li id="print" class="t_button"><a href="javascript:this.print();"> <span>Print</span></a></li> </ul> </div> </div> <div class="content mainContent"> <h1 class="title">Qt 3 Support Members for QSettings</h1> <p><b>The following class members are part of the <a href="qt3support.html">Qt 3 support layer</a>.</b> They are provided to help you port old code to Qt 4. We advise against using them in new code.</p> <p><ul><li><a href="qsettings.html">QSettings class reference</a></li></ul></p> <h2>Public Types</h2> <table class="alignedsummary"> <tr><td class="memItemLeft topAlign rightAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#System-enum">System</a></b> { Unix, Windows, Mac }</td></tr> </table> <h2>Public Functions</h2> <table class="alignedsummary"> <tr><td class="memItemLeft topAlign rightAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#entryList">entryList</a></b> ( const QString & <i>key</i> ) const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#insertSearchPath">insertSearchPath</a></b> ( System <i>system</i>, const QString & <i>path</i> )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#readBoolEntry">readBoolEntry</a></b> ( const QString & <i>key</i>, bool <i>defaultValue</i> = false, bool * <i>ok</i> = 0 )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> double </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#readDoubleEntry">readDoubleEntry</a></b> ( const QString & <i>key</i>, double <i>defaultValue</i> = 0, bool * <i>ok</i> = 0 )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#readEntry">readEntry</a></b> ( const QString & <i>key</i>, const QString & <i>defaultValue</i> = QString(), bool * <i>ok</i> = 0 )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#readListEntry">readListEntry</a></b> ( const QString & <i>key</i>, bool * <i>ok</i> = 0 )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#readListEntry-2">readListEntry</a></b> ( const QString & <i>key</i>, QChar <i>separator</i>, bool * <i>ok</i> = 0 )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#readNumEntry">readNumEntry</a></b> ( const QString & <i>key</i>, int <i>defaultValue</i> = 0, bool * <i>ok</i> = 0 )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#removeEntry">removeEntry</a></b> ( const QString & <i>key</i> )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#removeSearchPath">removeSearchPath</a></b> ( System <i>system</i>, const QString & <i>path</i> )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#resetGroup">resetGroup</a></b> ()</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#setPath-2">setPath</a></b> ( const QString & <i>organization</i>, const QString & <i>application</i>, Scope <i>scope</i> = Global )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#subkeyList">subkeyList</a></b> ( const QString & <i>key</i> ) const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#writeEntry">writeEntry</a></b> ( const QString & <i>key</i>, bool <i>value</i> )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#writeEntry-2">writeEntry</a></b> ( const QString & <i>key</i>, double <i>value</i> )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#writeEntry-3">writeEntry</a></b> ( const QString & <i>key</i>, int <i>value</i> )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#writeEntry-4">writeEntry</a></b> ( const QString & <i>key</i>, const char * <i>value</i> )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#writeEntry-5">writeEntry</a></b> ( const QString & <i>key</i>, const QString & <i>value</i> )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#writeEntry-6">writeEntry</a></b> ( const QString & <i>key</i>, const QStringList & <i>value</i> )</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qsettings-qt3.html#writeEntry-7">writeEntry</a></b> ( const QString & <i>key</i>, const QStringList & <i>value</i>, QChar <i>separator</i> )</td></tr> </table> <ul> <li class="fn">8 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li> </ul> <h2>Member Type Documentation</h2> <!-- $$$System$$$Unix$$$Windows$$$Mac --> <h3 class="fn"><a name="System-enum"></a>enum QSettings::<span class="name">System</span></h3> <table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr> <tr><td class="topAlign"><tt>QSettings::Unix</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">Unix systems (X11 and Embedded Linux)</td></tr> <tr><td class="topAlign"><tt>QSettings::Windows</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">Microsoft Windows systems</td></tr> <tr><td class="topAlign"><tt>QSettings::Mac</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">Mac OS X systems</td></tr> </table> <p><b>See also </b><a href="qsettings-qt3.html#insertSearchPath">insertSearchPath</a>() and <a href="qsettings-qt3.html#removeSearchPath">removeSearchPath</a>().</p> <!-- @@@System --> <h2>Member Function Documentation</h2> <!-- $$$entryList[overload1]$$$entryListconstQString& --> <h3 class="fn"><a name="entryList"></a><span class="type"><a href="qstringlist.html">QStringList</a></span> QSettings::<span class="name">entryList</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i> ) const</h3> <p>Returns a list of all sub-keys of <i>key</i>.</p> <p>Use <a href="qsettings.html#childKeys">childKeys</a>() instead.</p> <p>For example, if you have code like</p> <pre class="cpp"> QSettings settings; QStringList keys = settings.entryList("cities"); ...</pre> <p>you can rewrite it as</p> <pre class="cpp"> <span class="type"><a href="qsettings.html">QSettings</a></span> settings; settings<span class="operator">.</span><a href="qsettings.html#beginGroup">beginGroup</a>(<span class="string">"cities"</span>); <span class="type"><a href="qstringlist.html">QStringList</a></span> keys <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#childKeys">childKeys</a>(); <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span> settings<span class="operator">.</span><a href="qsettings.html#endGroup">endGroup</a>();</pre> <!-- @@@entryList --> <!-- $$$insertSearchPath[overload1]$$$insertSearchPathSystemconstQString& --> <h3 class="fn"><a name="insertSearchPath"></a><span class="type">void</span> QSettings::<span class="name">insertSearchPath</span> ( <span class="type"><a href="qsettings-qt3.html#System-enum">System</a></span> <i>system</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>path</i> )</h3> <p>This function is implemented as a no-op. It is provided for source compatibility with Qt 3. The new <a href="qsettings.html">QSettings</a> class has no concept of "search path".</p> <!-- @@@insertSearchPath --> <!-- $$$readBoolEntry[overload1]$$$readBoolEntryconstQString&boolbool* --> <h3 class="fn"><a name="readBoolEntry"></a><span class="type">bool</span> QSettings::<span class="name">readBoolEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, <span class="type">bool</span> <i>defaultValue</i> = false, <span class="type">bool</span> * <i>ok</i> = 0 )</h3> <p>Returns the value for setting <i>key</i> converted to a <tt>bool</tt>. If the setting doesn't exist, returns <i>defaultValue</i>.</p> <p>If <i>ok</i> is not 0, *<i>ok</i> is set to true if the key exists, otherwise *<i>ok</i> is set to false.</p> <p>Use <a href="qsettings.html#value">value</a>() instead.</p> <p>For example, if you have code like</p> <pre class="cpp"> bool ok; bool grid = settings.readBoolEntry("showGrid", true, &ok);</pre> <p>you can rewrite it as</p> <pre class="cpp"> <span class="type">bool</span> ok <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#contains">contains</a>(<span class="string">"showGrid"</span>); <span class="type">bool</span> grid <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#value">value</a>(<span class="string">"showGrid"</span><span class="operator">,</span> <span class="keyword">true</span>)<span class="operator">.</span>toBool();</pre> <!-- @@@readBoolEntry --> <!-- $$$readDoubleEntry[overload1]$$$readDoubleEntryconstQString&doublebool* --> <h3 class="fn"><a name="readDoubleEntry"></a><span class="type">double</span> QSettings::<span class="name">readDoubleEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, <span class="type">double</span> <i>defaultValue</i> = 0, <span class="type">bool</span> * <i>ok</i> = 0 )</h3> <p>Returns the value for setting <i>key</i> converted to a <tt>double</tt>. If the setting doesn't exist, returns <i>defaultValue</i>.</p> <p>If <i>ok</i> is not 0, *<i>ok</i> is set to true if the key exists, otherwise *<i>ok</i> is set to false.</p> <p>Use <a href="qsettings.html#value">value</a>() instead.</p> <p>For example, if you have code like</p> <pre class="cpp"> bool ok; double pi = settings.readDoubleEntry("pi", 3.141592, &ok);</pre> <p>you can rewrite it as</p> <pre class="cpp"> <span class="type">bool</span> ok <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#contains">contains</a>(<span class="string">"pi"</span>); <span class="type">double</span> pi <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#value">value</a>(<span class="string">"pi"</span><span class="operator">,</span> <span class="number">3.141592</span>)<span class="operator">.</span>toDouble();</pre> <!-- @@@readDoubleEntry --> <!-- $$$readEntry[overload1]$$$readEntryconstQString&constQString&bool* --> <h3 class="fn"><a name="readEntry"></a><span class="type"><a href="qstring.html">QString</a></span> QSettings::<span class="name">readEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>defaultValue</i> = QString(), <span class="type">bool</span> * <i>ok</i> = 0 )</h3> <p>Returns the value for setting <i>key</i> converted to a <a href="qstring.html">QString</a>. If the setting doesn't exist, returns <i>defaultValue</i>.</p> <p>If <i>ok</i> is not 0, *<i>ok</i> is set to true if the key exists, otherwise *<i>ok</i> is set to false.</p> <p>Use <a href="qsettings.html#value">value</a>() instead.</p> <p>For example, if you have code like</p> <pre class="cpp"> bool ok; QString str = settings.readEntry("userName", "administrator", &ok);</pre> <p>you can rewrite it as</p> <pre class="cpp"> <span class="type">bool</span> ok <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#contains">contains</a>(<span class="string">"userName"</span>); <span class="type"><a href="qstring.html">QString</a></span> str <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#value">value</a>(<span class="string">"userName"</span><span class="operator">,</span> <span class="string">"administrator"</span>)<span class="operator">.</span>toString();</pre> <!-- @@@readEntry --> <!-- $$$readListEntry[overload1]$$$readListEntryconstQString&bool* --> <h3 class="fn"><a name="readListEntry"></a><span class="type"><a href="qstringlist.html">QStringList</a></span> QSettings::<span class="name">readListEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, <span class="type">bool</span> * <i>ok</i> = 0 )</h3> <p>Returns the value of setting <i>key</i> converted to a <a href="qstringlist.html">QStringList</a>.</p> <p>If <i>ok</i> is not 0, *<i>ok</i> is set to true if the key exists, otherwise *<i>ok</i> is set to false.</p> <p>Use <a href="qsettings.html#value">value</a>() instead.</p> <p>For example, if you have code like</p> <pre class="cpp"> bool ok; QStringList list = settings.readListEntry("recentFiles", &ok);</pre> <p>you can rewrite it as</p> <pre class="cpp"> <span class="type">bool</span> ok <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#contains">contains</a>(<span class="string">"recentFiles"</span>); <span class="type"><a href="qstringlist.html">QStringList</a></span> list <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#value">value</a>(<span class="string">"recentFiles"</span>)<span class="operator">.</span>toStringList();</pre> <!-- @@@readListEntry --> <!-- $$$readListEntry$$$readListEntryconstQString&QCharbool* --> <h3 class="fn"><a name="readListEntry-2"></a><span class="type"><a href="qstringlist.html">QStringList</a></span> QSettings::<span class="name">readListEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, <span class="type"><a href="qchar.html">QChar</a></span> <i>separator</i>, <span class="type">bool</span> * <i>ok</i> = 0 )</h3> <p>Returns the value of setting <i>key</i> converted to a <a href="qstringlist.html">QStringList</a>. <i>separator</i> is ignored.</p> <p>If <i>ok</i> is not 0, *<i>ok</i> is set to true if the key exists, otherwise *<i>ok</i> is set to false.</p> <p>Use <a href="qsettings.html#value">value</a>() instead.</p> <p>For example, if you have code like</p> <pre class="cpp"> bool ok; QStringList list = settings.readListEntry("recentFiles", ":", &ok);</pre> <p>you can rewrite it as</p> <pre class="cpp"> <span class="type">bool</span> ok <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#contains">contains</a>(<span class="string">"recentFiles"</span>); <span class="type"><a href="qstringlist.html">QStringList</a></span> list <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#value">value</a>(<span class="string">"recentFiles"</span>)<span class="operator">.</span>toStringList();</pre> <!-- @@@readListEntry --> <!-- $$$readNumEntry[overload1]$$$readNumEntryconstQString&intbool* --> <h3 class="fn"><a name="readNumEntry"></a><span class="type">int</span> QSettings::<span class="name">readNumEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, <span class="type">int</span> <i>defaultValue</i> = 0, <span class="type">bool</span> * <i>ok</i> = 0 )</h3> <p>Returns the value for setting <i>key</i> converted to an <tt>int</tt>. If the setting doesn't exist, returns <i>defaultValue</i>.</p> <p>If <i>ok</i> is not 0, *<i>ok</i> is set to true if the key exists, otherwise *<i>ok</i> is set to false.</p> <p>Use <a href="qsettings.html#value">value</a>() instead.</p> <p>For example, if you have code like</p> <pre class="cpp"> bool ok; int max = settings.readNumEntry("maxConnections", 30, &ok);</pre> <p>you can rewrite it as</p> <pre class="cpp"> <span class="type">bool</span> ok <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#contains">contains</a>(<span class="string">"maxConnections"</span>); <span class="type">int</span> max <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#value">value</a>(<span class="string">"maxConnections"</span><span class="operator">,</span> <span class="number">30</span>)<span class="operator">.</span>toInt();</pre> <!-- @@@readNumEntry --> <!-- $$$removeEntry[overload1]$$$removeEntryconstQString& --> <h3 class="fn"><a name="removeEntry"></a><span class="type">bool</span> QSettings::<span class="name">removeEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i> )</h3> <p>Use <a href="qsettings.html#remove">remove</a>() instead.</p> <!-- @@@removeEntry --> <!-- $$$removeSearchPath[overload1]$$$removeSearchPathSystemconstQString& --> <h3 class="fn"><a name="removeSearchPath"></a><span class="type">void</span> QSettings::<span class="name">removeSearchPath</span> ( <span class="type"><a href="qsettings-qt3.html#System-enum">System</a></span> <i>system</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>path</i> )</h3> <p>This function is implemented as a no-op. It is provided for source compatibility with Qt 3. The new <a href="qsettings.html">QSettings</a> class has no concept of "search path".</p> <!-- @@@removeSearchPath --> <!-- $$$resetGroup[overload1]$$$resetGroup --> <h3 class="fn"><a name="resetGroup"></a><span class="type">void</span> QSettings::<span class="name">resetGroup</span> ()</h3> <p>Sets the current group to be the empty string.</p> <p>Use <a href="qsettings.html#endGroup">endGroup</a>() instead (possibly multiple times).</p> <p>For example, if you have code like</p> <pre class="cpp"> QSettings settings; settings.beginGroup("mainWindow"); settings.beginGroup("leftPanel"); ... settings.resetGroup();</pre> <p>you can rewrite it as</p> <pre class="cpp"> <span class="type"><a href="qsettings.html">QSettings</a></span> settings; settings<span class="operator">.</span><a href="qsettings.html#beginGroup">beginGroup</a>(<span class="string">"mainWindow"</span>); settings<span class="operator">.</span><a href="qsettings.html#beginGroup">beginGroup</a>(<span class="string">"leftPanel"</span>); <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span> settings<span class="operator">.</span><a href="qsettings.html#endGroup">endGroup</a>(); settings<span class="operator">.</span><a href="qsettings.html#endGroup">endGroup</a>();</pre> <!-- @@@resetGroup --> <!-- $$$setPath$$$setPathconstQString&constQString&Scope --> <h3 class="fn"><a name="setPath-2"></a><span class="type">void</span> QSettings::<span class="name">setPath</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>organization</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>application</i>, <span class="type"><a href="qsettings.html#Scope-enum">Scope</a></span> <i>scope</i> = Global )</h3> <p>Specifies the <i>organization</i>, <i>application</i>, and <i>scope</i> to use by the <a href="qsettings.html">QSettings</a> object.</p> <p>Use the appropriate constructor instead, with <a href="qsettings.html#Scope-enum">QSettings::UserScope</a> instead of <a href="qsettings.html#Scope-enum">QSettings::User</a> and <a href="qsettings.html#Scope-enum">QSettings::SystemScope</a> instead of <a href="qsettings.html#Scope-enum">QSettings::Global</a>.</p> <p>For example, if you have code like</p> <pre class="cpp"> QSettings settings; settings.setPath("twikimaster.com", "Kanooth", QSettings::Global);</pre> <p>you can rewrite it as</p> <pre class="cpp"> <span class="type"><a href="qsettings.html">QSettings</a></span> settings(<span class="type"><a href="qsettings.html">QSettings</a></span><span class="operator">::</span>SystemScope<span class="operator">,</span> <span class="string">"twikimaster.com"</span><span class="operator">,</span> <span class="string">"Kanooth"</span>);</pre> <!-- @@@setPath --> <!-- $$$subkeyList[overload1]$$$subkeyListconstQString& --> <h3 class="fn"><a name="subkeyList"></a><span class="type"><a href="qstringlist.html">QStringList</a></span> QSettings::<span class="name">subkeyList</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i> ) const</h3> <p>Returns a list of all sub-keys of <i>key</i>.</p> <p>Use <a href="qsettings.html#childGroups">childGroups</a>() instead.</p> <p>For example, if you have code like</p> <pre class="cpp"> QSettings settings; QStringList groups = settings.entryList("cities"); ...</pre> <p>you can rewrite it as</p> <pre class="cpp"> <span class="type"><a href="qsettings.html">QSettings</a></span> settings; settings<span class="operator">.</span><a href="qsettings.html#beginGroup">beginGroup</a>(<span class="string">"cities"</span>); <span class="type"><a href="qstringlist.html">QStringList</a></span> groups <span class="operator">=</span> settings<span class="operator">.</span><a href="qsettings.html#childKeys">childKeys</a>(); <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span> settings<span class="operator">.</span><a href="qsettings.html#endGroup">endGroup</a>();</pre> <!-- @@@subkeyList --> <!-- $$$writeEntry[overload1]$$$writeEntryconstQString&bool --> <h3 class="fn"><a name="writeEntry"></a><span class="type">bool</span> QSettings::<span class="name">writeEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, <span class="type">bool</span> <i>value</i> )</h3> <p>Sets the value of setting <i>key</i> to <i>value</i>.</p> <p>Use <a href="qsettings.html#setValue">setValue</a>() instead.</p> <!-- @@@writeEntry --> <!-- $$$writeEntry$$$writeEntryconstQString&double --> <h3 class="fn"><a name="writeEntry-2"></a><span class="type">bool</span> QSettings::<span class="name">writeEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, <span class="type">double</span> <i>value</i> )</h3> <p>This is an overloaded function.</p> <!-- @@@writeEntry --> <!-- $$$writeEntry$$$writeEntryconstQString&int --> <h3 class="fn"><a name="writeEntry-3"></a><span class="type">bool</span> QSettings::<span class="name">writeEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, <span class="type">int</span> <i>value</i> )</h3> <p>This is an overloaded function.</p> <!-- @@@writeEntry --> <!-- $$$writeEntry$$$writeEntryconstQString&constchar* --> <h3 class="fn"><a name="writeEntry-4"></a><span class="type">bool</span> QSettings::<span class="name">writeEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, const <span class="type">char</span> * <i>value</i> )</h3> <p>This is an overloaded function.</p> <!-- @@@writeEntry --> <!-- $$$writeEntry$$$writeEntryconstQString&constQString& --> <h3 class="fn"><a name="writeEntry-5"></a><span class="type">bool</span> QSettings::<span class="name">writeEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>value</i> )</h3> <p>This is an overloaded function.</p> <!-- @@@writeEntry --> <!-- $$$writeEntry$$$writeEntryconstQString&constQStringList& --> <h3 class="fn"><a name="writeEntry-6"></a><span class="type">bool</span> QSettings::<span class="name">writeEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, const <span class="type"><a href="qstringlist.html">QStringList</a></span> & <i>value</i> )</h3> <p>This is an overloaded function.</p> <!-- @@@writeEntry --> <!-- $$$writeEntry$$$writeEntryconstQString&constQStringList&QChar --> <h3 class="fn"><a name="writeEntry-7"></a><span class="type">bool</span> QSettings::<span class="name">writeEntry</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>key</i>, const <span class="type"><a href="qstringlist.html">QStringList</a></span> & <i>value</i>, <span class="type"><a href="qchar.html">QChar</a></span> <i>separator</i> )</h3> <p>This is an overloaded function.</p> <p>Use setValue(<i>key</i>, <i>value</i>) instead. You don't need <i>separator</i>.</p> <!-- @@@writeEntry --> </div> </div> </div> <div class="ft"> <span></span> </div> </div> <div class="footer"> <p> <acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners.</p> <br /> <p> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.</p> <p> Documentation sources may be obtained from <a href="http://www.qt-project.org"> www.qt-project.org</a>.</p> <br /> <p> Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. <a title="Privacy Policy" href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p> </div> <script src="scripts/functions.js" type="text/javascript"></script> </body> </html>