lili/qt4-x11
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
qt4-x11/doc/html/qsettings-qt3.html
lili 35a2a1d584 init
2025-08-24 20:55:26 +08:00

417 lines
34 KiB
HTML
Raw Permalink Blame History

<?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 &amp; 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>&nbsp;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 &amp; 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 &amp; <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 &amp; <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 &amp; <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 &amp; <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 &amp; <i>key</i>, const QString &amp; <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 &amp; <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 &amp; <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 &amp; <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 &amp; <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 &amp; <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 &amp; <i>organization</i>, const QString &amp; <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 &amp; <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 &amp; <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 &amp; <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 &amp; <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 &amp; <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 &amp; <i>key</i>, const QString &amp; <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 &amp; <i>key</i>, const QStringList &amp; <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 &amp; <i>key</i>, const QStringList &amp; <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> &amp; <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(&quot;cities&quot;);
..&#x2e;</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">&quot;cities&quot;</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> &amp; <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 &quot;search path&quot;.</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> &amp; <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(&quot;showGrid&quot;, true, &amp;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">&quot;showGrid&quot;</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">&quot;showGrid&quot;</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> &amp; <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(&quot;pi&quot;, 3.141592, &amp;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">&quot;pi&quot;</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">&quot;pi&quot;</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> &amp; <i>key</i>, const <span class="type"><a href="qstring.html">QString</a></span> &amp; <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(&quot;userName&quot;, &quot;administrator&quot;, &amp;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">&quot;userName&quot;</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">&quot;userName&quot;</span><span class="operator">,</span> <span class="string">&quot;administrator&quot;</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> &amp; <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(&quot;recentFiles&quot;, &amp;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">&quot;recentFiles&quot;</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">&quot;recentFiles&quot;</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> &amp; <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(&quot;recentFiles&quot;, &quot;:&quot;, &amp;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">&quot;recentFiles&quot;</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">&quot;recentFiles&quot;</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> &amp; <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(&quot;maxConnections&quot;, 30, &amp;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">&quot;maxConnections&quot;</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">&quot;maxConnections&quot;</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> &amp; <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> &amp; <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 &quot;search path&quot;.</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(&quot;mainWindow&quot;);
settings.beginGroup(&quot;leftPanel&quot;);
..&#x2e;
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">&quot;mainWindow&quot;</span>);
settings<span class="operator">.</span><a href="qsettings.html#beginGroup">beginGroup</a>(<span class="string">&quot;leftPanel&quot;</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> &amp; <i>organization</i>, const <span class="type"><a href="qstring.html">QString</a></span> &amp; <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(&quot;twikimaster.com&quot;, &quot;Kanooth&quot;, 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">&quot;twikimaster.com&quot;</span><span class="operator">,</span> <span class="string">&quot;Kanooth&quot;</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> &amp; <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(&quot;cities&quot;);
..&#x2e;</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">&quot;cities&quot;</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> &amp; <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> &amp; <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> &amp; <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> &amp; <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> &amp; <i>key</i>, const <span class="type"><a href="qstring.html">QString</a></span> &amp; <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> &amp; <i>key</i>, const <span class="type"><a href="qstringlist.html">QStringList</a></span> &amp; <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> &amp; <i>key</i>, const <span class="type"><a href="qstringlist.html">QStringList</a></span> &amp; <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">&copy;</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>
Reference in New Issue View Git Blame Copy Permalink