~oif-team/ubuntu/natty/qt4-x11/xi2.1

<td width="1">  </td><td class="postheader" valign="center"><a href="index.html">Home</a> · <a href="classes.html">All Classes</a> · <a href="mainclasses.html">Main Classes</a> · <a href="annotated.html">Annotated</a> · <a href="groups.html">Grouped Classes</a> · <a href="functions.html">Functions</a></td>

<td align="right" valign="top" width="230"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></td></tr></table><h1 align="center">Qt 3 Support Members for QSettings</h1>

The following class members are part of the Qt 3 support layer. They are provided to help you port old code to Qt 4. We advise against using them in new code.

<ul><li><a href="qsettings.html">QSettings class reference</a></li></ul>

<h3>Public Types</h3>

<ul>

<li><div class="fn"/>enum <a href="qsettings-qt3.html#System-enum">System</a> { Unix, Windows, Mac }</li>

</ul>

<h3>Public Functions</h3>

<ul>

<li><div class="fn"/>QStringList <a href="qsettings-qt3.html#entryList">entryList</a> ( const QString & key ) const</li>

<li><div class="fn"/>void <a href="qsettings-qt3.html#insertSearchPath">insertSearchPath</a> ( System system, const QString & path )</li>

<li><div class="fn"/>bool <a href="qsettings-qt3.html#readBoolEntry">readBoolEntry</a> ( const QString & key, bool defaultValue = false, bool * ok = 0 )</li>

<li><div class="fn"/>double <a href="qsettings-qt3.html#readDoubleEntry">readDoubleEntry</a> ( const QString & key, double defaultValue = 0, bool * ok = 0 )</li>

<li><div class="fn"/>QString <a href="qsettings-qt3.html#readEntry">readEntry</a> ( const QString & key, const QString & defaultValue = QString(), bool * ok = 0 )</li>

<li><div class="fn"/>QStringList <a href="qsettings-qt3.html#readListEntry">readListEntry</a> ( const QString & key, bool * ok = 0 )</li>

<li><div class="fn"/>QStringList <a href="qsettings-qt3.html#readListEntry-2">readListEntry</a> ( const QString & key, QChar separator, bool * ok = 0 )</li>

<li><div class="fn"/>int <a href="qsettings-qt3.html#readNumEntry">readNumEntry</a> ( const QString & key, int defaultValue = 0, bool * ok = 0 )</li>

<li><div class="fn"/>bool <a href="qsettings-qt3.html#removeEntry">removeEntry</a> ( const QString & key )</li>

<li><div class="fn"/>void <a href="qsettings-qt3.html#removeSearchPath">removeSearchPath</a> ( System system, const QString & path )</li>

<li><div class="fn"/>void <a href="qsettings-qt3.html#resetGroup">resetGroup</a> ()</li>

<li><div class="fn"/>void <a href="qsettings-qt3.html#setPath">setPath</a> ( const QString & organization, const QString & application, Scope scope = Global )</li>

<li><div class="fn"/>QStringList <a href="qsettings-qt3.html#subkeyList">subkeyList</a> ( const QString & key ) const</li>

<li><div class="fn"/>bool <a href="qsettings-qt3.html#writeEntry">writeEntry</a> ( const QString & key, bool value )</li>

<li><div class="fn"/>bool <a href="qsettings-qt3.html#writeEntry-2">writeEntry</a> ( const QString & key, double value )</li>

<li><div class="fn"/>bool <a href="qsettings-qt3.html#writeEntry-3">writeEntry</a> ( const QString & key, int value )</li>

<li><div class="fn"/>bool <a href="qsettings-qt3.html#writeEntry-4">writeEntry</a> ( const QString & key, const char * value )</li>

<li><div class="fn"/>bool <a href="qsettings-qt3.html#writeEntry-5">writeEntry</a> ( const QString & key, const QString & value )</li>

<li><div class="fn"/>bool <a href="qsettings-qt3.html#writeEntry-6">writeEntry</a> ( const QString & key, const QStringList & value )</li>

<li><div class="fn"/>bool <a href="qsettings-qt3.html#writeEntry-7">writeEntry</a> ( const QString & key, const QStringList & value, QChar separator )</li>

</ul>

<ul>

<li><div class="fn"/>8 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>

</ul>

<hr />

<h2>Member Type Documentation</h2>

<h3 class="fn"><a name="System-enum"></a>enum QSettings::System</h3>

<tr><th width="25%">Constant</th><th width="15%">Value</th><th width="60%">Description</th></tr>

<tr><td valign="top"><tt>QSettings::Unix</tt></td><td align="center" valign="top"><tt>0</tt></td><td valign="top">Unix/<a href="winsystem.html#x11">X11</a> systems</td></tr>

<tr><td valign="top"><tt>QSettings::Windows</tt></td><td align="center" valign="top"><tt>1</tt></td><td valign="top">Microsoft Windows systems</td></tr>

<tr><td valign="top"><tt>QSettings::Mac</tt></td><td align="center" valign="top"><tt>2</tt></td><td valign="top">Mac OS X systems</td></tr>

</table>

See also <a href="qsettings-qt3.html#insertSearchPath">insertSearchPath</a>() and <a href="qsettings-qt3.html#removeSearchPath">removeSearchPath</a>().

<hr />

<h2>Member Function Documentation</h2>

<h3 class="fn"><a name="entryList"></a><a href="qstringlist.html">QStringList</a> QSettings::entryList ( const <a href="qstring.html">QString</a> & key ) const</h3>

Returns a list of all sub-keys of key.

Use <a href="qsettings.html#childKeys">childKeys</a>() instead.

For example, if you have code like

<pre> QSettings settings;

QStringList keys = settings.entryList("cities");

...</pre>

you can rewrite it as

<pre> QSettings settings;

settings.beginGroup("cities");

QStringList keys = settings.childKeys();

...

settings.endGroup();</pre>

<h3 class="fn"><a name="insertSearchPath"></a>void QSettings::insertSearchPath ( <a href="qsettings-qt3.html#System-enum">System</a> system, const <a href="qstring.html">QString</a> & path )</h3>

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".

<h3 class="fn"><a name="readBoolEntry"></a>bool QSettings::readBoolEntry ( const <a href="qstring.html">QString</a> & key, bool defaultValue = false, bool * ok = 0 )</h3>

Returns the value for setting key converted to a <tt>bool</tt>. If the setting doesn't exist, returns defaultValue.

If ok is not 0, *ok is set to true if the key exists, otherwise *ok is set to false.

Use <a href="qsettings.html#value">value</a>() instead.

For example, if you have code like

<pre> bool ok;

bool grid = settings.readBoolEntry("showGrid", true, &ok);</pre>

you can rewrite it as

<pre> bool ok = settings.contains("showGrid");

bool grid = settings.value("showGrid", true).toBool();</pre>

<h3 class="fn"><a name="readDoubleEntry"></a>double QSettings::readDoubleEntry ( const <a href="qstring.html">QString</a> & key, double defaultValue = 0, bool * ok = 0 )</h3>

Returns the value for setting key converted to a <tt>double</tt>. If the setting doesn't exist, returns defaultValue.

If ok is not 0, *ok is set to true if the key exists, otherwise *ok is set to false.

Use <a href="qsettings.html#value">value</a>() instead.

For example, if you have code like

<pre> bool ok;

double pi = settings.readDoubleEntry("pi", 3.141592, &ok);</pre>

you can rewrite it as

<pre> bool ok = settings.contains("pi");

double pi = settings.value("pi", 3.141592).toDouble();</pre>

100

<h3 class="fn"><a name="readEntry"></a><a href="qstring.html">QString</a> QSettings::readEntry ( const <a href="qstring.html">QString</a> & key, const <a href="qstring.html">QString</a> & defaultValue = QString(), bool * ok = 0 )</h3>

101

Returns the value for setting key converted to a <a href="qstring.html">QString</a>. If the setting doesn't exist, returns defaultValue.

102

If ok is not 0, *ok is set to true if the key exists, otherwise *ok is set to false.

103

Use <a href="qsettings.html#value">value</a>() instead.

104

For example, if you have code like

105

<pre> bool ok;

106

QString str = settings.readEntry("userName", "administrator", &ok);</pre>

107

you can rewrite it as

108

<pre> bool ok = settings.contains("userName");

109

QString str = settings.value("userName", "administrator").toString();</pre>

110

<h3 class="fn"><a name="readListEntry"></a><a href="qstringlist.html">QStringList</a> QSettings::readListEntry ( const <a href="qstring.html">QString</a> & key, bool * ok = 0 )</h3>

111

Returns the value of setting key converted to a <a href="qstringlist.html">QStringList</a>.

112

If ok is not 0, *ok is set to true if the key exists, otherwise *ok is set to false.

113

Use <a href="qsettings.html#value">value</a>() instead.

114

For example, if you have code like

115

<pre> bool ok;

116

QStringList list = settings.readListEntry("recentFiles", &ok);</pre>

117

you can rewrite it as

118

<pre> bool ok = settings.contains("recentFiles");

119

QStringList list = settings.value("recentFiles").toStringList();</pre>

120

<h3 class="fn"><a name="readListEntry-2"></a><a href="qstringlist.html">QStringList</a> QSettings::readListEntry ( const <a href="qstring.html">QString</a> & key, <a href="qchar.html">QChar</a> separator, bool * ok = 0 )</h3>

121

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

122

Returns the value of setting key converted to a <a href="qstringlist.html">QStringList</a>. separator is ignored.

123

If ok is not 0, *ok is set to true if the key exists, otherwise *ok is set to false.

124

Use <a href="qsettings.html#value">value</a>() instead.

125

For example, if you have code like

126

<pre> bool ok;

127

QStringList list = settings.readListEntry("recentFiles", ":", &ok);</pre>

128

you can rewrite it as

129

<pre> bool ok = settings.contains("recentFiles");

130

QStringList list = settings.value("recentFiles").toStringList();</pre>

131

<h3 class="fn"><a name="readNumEntry"></a>int QSettings::readNumEntry ( const <a href="qstring.html">QString</a> & key, int defaultValue = 0, bool * ok = 0 )</h3>

132

Returns the value for setting key converted to an <tt>int</tt>. If the setting doesn't exist, returns defaultValue.

133

If ok is not 0, *ok is set to true if the key exists, otherwise *ok is set to false.

134

Use <a href="qsettings.html#value">value</a>() instead.

135

For example, if you have code like

136

<pre> bool ok;

137

int max = settings.readNumEntry("maxConnections", 30, &ok);</pre>

138

you can rewrite it as

139

<pre> bool ok = settings.contains("maxConnections");

140

int max = settings.value("maxConnections", 30).toInt();</pre>

141

<h3 class="fn"><a name="removeEntry"></a>bool QSettings::removeEntry ( const <a href="qstring.html">QString</a> & key )</h3>

142

Use <a href="qsettings.html#remove">remove</a>() instead.

143

<h3 class="fn"><a name="removeSearchPath"></a>void QSettings::removeSearchPath ( <a href="qsettings-qt3.html#System-enum">System</a> system, const <a href="qstring.html">QString</a> & path )</h3>

144

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".

145

<h3 class="fn"><a name="resetGroup"></a>void QSettings::resetGroup ()</h3>

146

Sets the current group to be the empty string.

147

Use <a href="qsettings.html#endGroup">endGroup</a>() instead (possibly multiple times).

148

For example, if you have code like

149

<pre> QSettings settings;

150

settings.beginGroup("mainWindow");

151

settings.beginGroup("leftPanel");

152

...

153

settings.resetGroup();</pre>

154

you can rewrite it as

155

<pre> QSettings settings;

156

settings.beginGroup("mainWindow");

157

settings.beginGroup("leftPanel");

158

...

159

settings.endGroup();

160

settings.endGroup();</pre>

161

<h3 class="fn"><a name="setPath"></a>void QSettings::setPath ( const <a href="qstring.html">QString</a> & organization, const <a href="qstring.html">QString</a> & application, <a href="qsettings.html#Scope-enum">Scope</a> scope = Global )</h3>

162

Specifies the organization, application, and scope to use by the <a href="qsettings.html">QSettings</a> object.

163

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>.

164

For example, if you have code like

165

<pre> QSettings settings;

166

settings.setPath("twikimaster.com", "Kanooth", QSettings::Global);</pre>

167

you can rewrite it as

168

<pre> QSettings settings(QSettings::SystemScope, "twikimaster.com", "Kanooth");</pre>

169

<h3 class="fn"><a name="subkeyList"></a><a href="qstringlist.html">QStringList</a> QSettings::subkeyList ( const <a href="qstring.html">QString</a> & key ) const</h3>

170

Returns a list of all sub-keys of key.

171

Use <a href="qsettings.html#childGroups">childGroups</a>() instead.

172

For example, if you have code like

173

<pre> QSettings settings;

174

QStringList groups = settings.entryList("cities");

175

...</pre>

176

you can rewrite it as

177

<pre> QSettings settings;

178

settings.beginGroup("cities");

179

QStringList groups = settings.childKeys();

180

...

181

settings.endGroup();</pre>

182

<h3 class="fn"><a name="writeEntry"></a>bool QSettings::writeEntry ( const <a href="qstring.html">QString</a> & key, bool value )</h3>

183

Sets the value of setting key to value.

184

Use <a href="qsettings.html#setValue">setValue</a>() instead.

185

<h3 class="fn"><a name="writeEntry-2"></a>bool QSettings::writeEntry ( const <a href="qstring.html">QString</a> & key, double value )</h3>

186

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

187

<h3 class="fn"><a name="writeEntry-3"></a>bool QSettings::writeEntry ( const <a href="qstring.html">QString</a> & key, int value )</h3>

188

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

189

<h3 class="fn"><a name="writeEntry-4"></a>bool QSettings::writeEntry ( const <a href="qstring.html">QString</a> & key, const char * value )</h3>

190

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

191

<h3 class="fn"><a name="writeEntry-5"></a>bool QSettings::writeEntry ( const <a href="qstring.html">QString</a> & key, const <a href="qstring.html">QString</a> & value )</h3>

192

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

193

<h3 class="fn"><a name="writeEntry-6"></a>bool QSettings::writeEntry ( const <a href="qstring.html">QString</a> & key, const <a href="qstringlist.html">QStringList</a> & value )</h3>

194

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

195

<h3 class="fn"><a name="writeEntry-7"></a>bool QSettings::writeEntry ( const <a href="qstring.html">QString</a> & key, const <a href="qstringlist.html">QStringList</a> & value, <a href="qchar.html">QChar</a> separator )</h3>

196

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

197

Use setValue(key, value) instead. You don't need separator.

198

199

200

201

<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>

202

203

</tr></table></div></address></body>

204

</html>

Older »