glib-keyed-data-lists.html

最新gtk中文资料集

<td><p><span class="term"><em class="parameter"><code>dl</code></em>&#160;:</span></p></td>
<td>a datalist.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></p></td>
<td>the string identifying the data element.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3354781"></a><h3>
<a name="g-datalist-remove-no-notify"></a>g_datalist_remove_no_notify()</h3>
<a class="indexterm" name="id3354795"></a><pre class="programlisting">#define             g_datalist_remove_no_notify(dl, k)</pre>
<p>
Removes an element, without calling its destroy notifier.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>dl</code></em>&#160;:</span></p></td>
<td>a datalist.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></p></td>
<td>the string identifying the data element.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3354844"></a><h3>
<a name="g-datalist-foreach"></a>g_datalist_foreach ()</h3>
<a class="indexterm" name="id3354857"></a><pre class="programlisting">void                g_datalist_foreach                  (<a class="link" href="glib-Keyed-Data-Lists.html#GData">GData</a> **datalist,
                                                         <a class="link" href="glib-Datasets.html#GDataForeachFunc">GDataForeachFunc</a> func,
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
<p>
Calls the given function for each data element of the datalist.
The function is called with each data element's <a class="link" href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> id and data,
together with the given <em class="parameter"><code>user_data</code></em> parameter.
Note that this function is NOT thread-safe. So unless <em class="parameter"><code>datalist</code></em>
can be protected from any modifications during invocation of this
function, it should not be called.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>datalist</code></em>&#160;:</span></p></td>
<td>a datalist.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></p></td>
<td>the function to call for each data element.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data to pass to the function.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3354974"></a><h3>
<a name="g-datalist-clear"></a>g_datalist_clear ()</h3>
<a class="indexterm" name="id3354986"></a><pre class="programlisting">void                g_datalist_clear                    (<a class="link" href="glib-Keyed-Data-Lists.html#GData">GData</a> **datalist);</pre>
<p>
Frees all the data elements of the datalist.
The data elements' destroy functions are called if they have been set.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>datalist</code></em>&#160;:</span></p></td>
<td>a datalist.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3355035"></a><h3>
<a name="g-datalist-set-flags"></a>g_datalist_set_flags ()</h3>
<a class="indexterm" name="id3355051"></a><pre class="programlisting">void                g_datalist_set_flags                (<a class="link" href="glib-Keyed-Data-Lists.html#GData">GData</a> **datalist,
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> flags);</pre>
<p>
Turns on flag values for a data list. This function is used
to keep a small number of boolean flags in an object with
a data list without using any additional space. It is
not generally useful except in circumstances where space
is very tight. (It is used in the base <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
><span class="type">GObject</span></a> type, for
example.)</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>datalist</code></em>&#160;:</span></p></td>
<td> pointer to the location that holds a list
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em>&#160;:</span></p></td>
<td> the flags to turn on. The values of the flags are
  restricted by <a class="link" href="glib-Keyed-Data-Lists.html#G-DATALIST-FLAGS-MASK:CAPS"><code class="literal">G_DATALIST_FLAGS_MASK</code></a> (currently
  3; giving two possible boolean flags).
  A value for <em class="parameter"><code>flags</code></em> that doesn't fit within the mask is
  an error.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3355164"></a><h3>
<a name="g-datalist-unset-flags"></a>g_datalist_unset_flags ()</h3>
<a class="indexterm" name="id3355179"></a><pre class="programlisting">void                g_datalist_unset_flags              (<a class="link" href="glib-Keyed-Data-Lists.html#GData">GData</a> **datalist,
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> flags);</pre>
<p>
Turns off flag values for a data list. See <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-unset-flags"><code class="function">g_datalist_unset_flags()</code></a></p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>datalist</code></em>&#160;:</span></p></td>
<td> pointer to the location that holds a list
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em>&#160;:</span></p></td>
<td> the flags to turn off. The values of the flags are
  restricted by <a class="link" href="glib-Keyed-Data-Lists.html#G-DATALIST-FLAGS-MASK:CAPS"><code class="literal">G_DATALIST_FLAGS_MASK</code></a> (currently
  3: giving two possible boolean flags).
  A value for <em class="parameter"><code>flags</code></em> that doesn't fit within the mask is
  an error.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3355288"></a><h3>
<a name="g-datalist-get-flags"></a>g_datalist_get_flags ()</h3>
<a class="indexterm" name="id3355303"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint">guint</a>               g_datalist_get_flags                (<a class="link" href="glib-Keyed-Data-Lists.html#GData">GData</a> **datalist);</pre>
<p>
Gets flags values packed in together with the datalist.
See <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-flags"><code class="function">g_datalist_set_flags()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>datalist</code></em>&#160;:</span></p></td>
<td> pointer to the location that holds a list
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the flags of the datalist

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3355383"></a><h3>
<a name="G-DATALIST-FLAGS-MASK:CAPS"></a>G_DATALIST_FLAGS_MASK</h3>
<a class="indexterm" name="id3355396"></a><pre class="programlisting">#define G_DATALIST_FLAGS_MASK 0x3
</pre>
<p>
A bitmask that restricts the possible flags passed to
<a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-flags"><code class="function">g_datalist_set_flags()</code></a>. Passing a flags value where
flags &amp; ~G_DATALIST_FLAGS_MASK != 0 is an error.</p>
<p>

</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3355432"></a><div class="refsect2" lang="en"><a name="id3355433"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id3355434"></a></div>
</div>
</div>
</body>
</html>