libgnome-gnome-config.html

来自「最新gtk中文资料集」· HTML 代码 · 共 1,690 行 · 第 1/5 页

<h3 class="title">Warning</h3>
<p><code class="literal">gnome_config_get_vector</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Retrieves the value of a configuration item as a string array.
The returned vector should be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a> when no longer needed.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em>&#160;:</span></td>
<td> A gnome configuration path to an item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argcp</code></em>&#160;:</span></td>
<td> Number of elements in the vector.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argvp</code></em>&#160;:</span></td>
<td> Vector of strings.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2803896"></a><h3>
<a name="gnome-config-get-vector-with-default"></a>gnome_config_get_vector_with_default()</h3>
<a class="indexterm" name="id2803912"></a><pre class="programlisting">#define     gnome_config_get_vector_with_default(path, argcp, argvp, def)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_config_get_vector_with_default</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Retrieves the value of a configuration item as a string array.
The returned vector should be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a> when no longer needed.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em>&#160;:</span></td>
<td> A gnome configuration path to an item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argcp</code></em>&#160;:</span></td>
<td> Number of elements in the vector.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argvp</code></em>&#160;:</span></td>
<td> Vector of strings.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>def</code></em>&#160;:</span></td>
<td> A pointer to a flag that will be set if the default value for the item
is returned.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804019"></a><h3>
<a name="gnome-config-private-get-vector"></a>gnome_config_private_get_vector()</h3>
<a class="indexterm" name="id2804034"></a><pre class="programlisting">#define     gnome_config_private_get_vector(path, argcp, argvp)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_config_private_get_vector</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Retrieves the value of a configuration item as a string array.
The returned vector should be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a> when no longer needed. The
configuration value is retrieved from the user's private configuration
storage area.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em>&#160;:</span></td>
<td> A gnome configuration path to an item in the user-private namespace.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argcp</code></em>&#160;:</span></td>
<td> Number of elements in the vector.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argvp</code></em>&#160;:</span></td>
<td> Vector of strings.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804128"></a><h3>
<a name="gnome-config-private-get-vector-with-default"></a>gnome_config_private_get_vector_with_default()</h3>
<a class="indexterm" name="id2804144"></a><pre class="programlisting">#define     gnome_config_private_get_vector_with_default(path, argcp, argvp, def)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_config_private_get_vector_with_default</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Retrieves the value of a configuration item as a string array.
The returned vector should be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a> when no longer needed. The
configuration value is retrieved from the user's private configuration
storage area.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em>&#160;:</span></td>
<td> A gnome configuration path to an item in the user-private namespace.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argcp</code></em>&#160;:</span></td>
<td> Number of elements in the vector
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argvp</code></em>&#160;:</span></td>
<td> Vector of strings
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>def</code></em>&#160;:</span></td>
<td> A pointer to a flag that will be set if the default value for the item
is returned.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804253"></a><h3>
<a name="gnome-config-set-vector"></a>gnome_config_set_vector()</h3>
<a class="indexterm" name="id2804268"></a><pre class="programlisting">#define     gnome_config_set_vector(path,argc,argv)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_config_set_vector</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Stores vector <em class="parameter"><code>argv</code></em> in the file/section/key defined by
<em class="parameter"><code>path</code></em>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em>&#160;:</span></td>
<td> A gnome configuration path to a key.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argc</code></em>&#160;:</span></td>
<td> The number of elements in <em class="parameter"><code>argv</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argv</code></em>&#160;:</span></td>
<td> A string array holding the data to store.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804365"></a><h3>
<a name="gnome-config-private-set-vector"></a>gnome_config_private_set_vector()</h3>
<a class="indexterm" name="id2804380"></a><pre class="programlisting">#define     gnome_config_private_set_vector(path,argc,argv)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_config_private_set_vector</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Stores vector <em class="parameter"><code>argv</code></em> in the file/section/key defined by <em class="parameter"><code>path</code></em>. The
configuration value is set in the user's private storage area.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em>&#160;:</span></td>
<td> A gnome configuration path to a key.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argc</code></em>&#160;:</span></td>
<td> The number of elements in <em class="parameter"><code>argv</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argv</code></em>&#160;:</span></td>
<td> A string array holding the data to store.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804479"></a><h3>
<a name="gnome-config-assemble-vector"></a>gnome_config_assemble_vector ()</h3>
<a class="indexterm" name="id2804494"></a><pre class="programlisting">char*       gnome_config_assemble_vector    (int argc,
                                             const char *const argv[]);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_config_assemble_vector</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This routine returns the the strings in the array contactenated by
spaces. The return value should be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a> when it is no longer
required.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>argc</code></em>&#160;:</span></td>
<td> Number of elements in the <em class="parameter"><code>argv</code></em> string array.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>argv</code></em>&#160;:</span></td>
<td> An array of strings.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> A string with the concatenation results.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804608"></a><h3>
<a name="gnome-config-has-section"></a>gnome_config_has_section()</h3>
<a class="indexterm" name="id2804623"></a><pre class="programlisting">#define     gnome_config_has_section(path)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_config_has_section</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Queries the gnome configuration file for the presence
of the section specified in <em class="parameter"><code>path</code></em>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>path</code></em>&#160;:</span></td>
<td> A gnome configuration path to a section
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the section exists, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2804712"></a><h3>
<a name="gnome-config-private-has-section"></a>gnome_con