~ubuntu-branches/ubuntu/oneiric/gconf/oneiric-proposed

« back to all changes in this revision

Viewing changes to doc/gconf/html/gconf-gconf-listeners.html

  • Committer: Bazaar Package Importer
  • Author(s): Emilio Pozuelo Monfort, Josselin Mouette, Sjoerd Simons, Emilio Pozuelo Monfort
  • Date: 2010-12-06 00:53:14 UTC
  • mfrom: (1.1.25 upstream)
  • mto: (7.3.4 sid)
  • mto: This revision was merged to the branch mainline in revision 58.
  • Revision ID: james.westby@ubuntu.com-20101206005314-uz89yke6r1xfw504
Tags: 2.32.1-1
[ Josselin Mouette ]
* Include patch-translations.mk, bump build-depends accordingly.
* Include 03_error_message.patch in POTFILES.in.
* pt_BR.po: Brazilian Portuguese translation. Closes: #599032.
* fr.po: French translation by Christian Perrier. Closes: #599049.
* da.po: Danish translation by Joe Hansen. Closes: #599125.
* cs.po: Czech translation by Michal Simunek. Closes: #599198.
* update-gconf-defaults: patch from Ubuntu to deal with broken 
  symlinks. Closes: #599393. Thanks Michael Vogt.
* de.po: German translation by Helge Kreutzmann. Closes: #599683.
* sv.po: Swedish translation by Martin Bagge. Closes: #599854.
* 04_manpage.patch: patch from A. Costa. Fixes typos in the manual 
  page. Closes: #600899.

[ Sjoerd Simons ]
* New upstream release
* Bump gobject-introspection to the lastest version to generate the most
  recent .gir version
* debian/patches/03_error_message.patch
  + Removed, merged upstream
* debian/rules:
  + Specify compilation with gtk2

[ Emilio Pozuelo Monfort ]
* Switch to source format 3.0 (quilt).
* debian/patches/*:
  - Updated to apply cleanly.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>gconf-listeners</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
7
<link rel="home" href="index.html" title="GConf Reference Manual">
8
8
<link rel="up" href="ch01.html" title="Using the GConf library">
9
9
<link rel="prev" href="gconf-gconf-internals.html" title="gconf-internals">
39
39
<a name="gconf-gconf-listeners.synopsis"></a><h2>Synopsis</h2>
40
40
<pre class="synopsis">                    <a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners">GConfListeners</a>;
41
41
<span class="returnvalue">void</span>                (<a class="link" href="gconf-gconf-listeners.html#GConfListenersCallback" title="GConfListenersCallback ()">*GConfListenersCallback</a>)           (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
42
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *all_above_key</code></em>,
43
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>,
44
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> listener_data</code></em>,
45
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
42
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *all_above_key</code></em>,
 
43
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>,
 
44
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> listener_data</code></em>,
 
45
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
46
46
<a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="returnvalue">GConfListeners</span></a>*     <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-new" title="gconf_listeners_new ()">gconf_listeners_new</a>                 (<em class="parameter"><code><span class="type">void</span></code></em>);
47
47
<span class="returnvalue">void</span>                <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-free" title="gconf_listeners_free ()">gconf_listeners_free</a>                (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>);
48
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-add" title="gconf_listeners_add ()">gconf_listeners_add</a>                 (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
49
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *listen_point</code></em>,
50
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> listener_data</code></em>,
51
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#GFreeFunc"><span class="type">GFreeFunc</span></a> destroy_notify</code></em>);
 
48
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-add" title="gconf_listeners_add ()">gconf_listeners_add</a>                 (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
 
49
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *listen_point</code></em>,
 
50
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> listener_data</code></em>,
 
51
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#GFreeFunc"><span class="type">GFreeFunc</span></a> destroy_notify</code></em>);
52
52
<span class="returnvalue">void</span>                <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-remove" title="gconf_listeners_remove ()">gconf_listeners_remove</a>              (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
53
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>);
 
53
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>);
54
54
<span class="returnvalue">void</span>                <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-notify" title="gconf_listeners_notify ()">gconf_listeners_notify</a>              (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
55
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *all_above</code></em>,
 
55
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *all_above</code></em>,
56
56
                                                         <em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListenersCallback" title="GConfListenersCallback ()"><span class="type">GConfListenersCallback</span></a> callback</code></em>,
57
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
58
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-count" title="gconf_listeners_count ()">gconf_listeners_count</a>               (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>);
 
57
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
58
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-count" title="gconf_listeners_count ()">gconf_listeners_count</a>               (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>);
59
59
<span class="returnvalue">void</span>                <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-foreach" title="gconf_listeners_foreach ()">gconf_listeners_foreach</a>             (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
60
60
                                                         <em class="parameter"><code><span class="type">GConfListenersForeach</span> callback</code></em>,
61
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
62
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-get-data" title="gconf_listeners_get_data ()">gconf_listeners_get_data</a>            (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
63
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>,
64
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *listener_data_p</code></em>,
65
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **location_p</code></em>);
 
61
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
62
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-get-data" title="gconf_listeners_get_data ()">gconf_listeners_get_data</a>            (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
 
63
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>,
 
64
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *listener_data_p</code></em>,
 
65
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **location_p</code></em>);
66
66
<span class="returnvalue">void</span>                <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-remove-if" title="gconf_listeners_remove_if ()">gconf_listeners_remove_if</a>           (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
67
67
                                                         <em class="parameter"><code><span class="type">GConfListenersPredicate</span> predicate</code></em>,
68
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
68
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
69
69
</pre>
70
70
</div>
71
71
<div class="refsect1" title="Description">
82
82
<a name="GConfListeners"></a><h3>GConfListeners</h3>
83
83
<pre class="programlisting">typedef struct _GConfListeners GConfListeners;</pre>
84
84
<p>
85
 
The <a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> structure contains nothing other than a dummy pointer. Internally
 
85
The <a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> structure contains nothing other than a dummy pointer. Internally 
86
86
the data about listeners is maintained through a listener table structure,
87
87
LTable which contains data like the namespace, an array to hold the listeners, count of
88
88
active listeners,value to be given to the next connection and the list of connection indices
93
93
<div class="refsect2" title="GConfListenersCallback ()">
94
94
<a name="GConfListenersCallback"></a><h3>GConfListenersCallback ()</h3>
95
95
<pre class="programlisting"><span class="returnvalue">void</span>                (*GConfListenersCallback)           (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
96
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *all_above_key</code></em>,
97
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>,
98
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> listener_data</code></em>,
99
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
96
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *all_above_key</code></em>,
 
97
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>,
 
98
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> listener_data</code></em>,
 
99
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
100
100
<p>
101
101
This is the signature of a user function added with <a class="link" href="gconf-gconf-listeners.html#gconf-listeners-notify" title="gconf_listeners_notify ()"><code class="function">gconf_listeners_notify()</code></a>. This function
102
102
is called whenever the value of a key changes.
167
167
<hr>
168
168
<div class="refsect2" title="gconf_listeners_add ()">
169
169
<a name="gconf-listeners-add"></a><h3>gconf_listeners_add ()</h3>
170
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gconf_listeners_add                 (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
171
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *listen_point</code></em>,
172
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> listener_data</code></em>,
173
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#GFreeFunc"><span class="type">GFreeFunc</span></a> destroy_notify</code></em>);</pre>
 
170
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gconf_listeners_add                 (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
 
171
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *listen_point</code></em>,
 
172
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> listener_data</code></em>,
 
173
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#GFreeFunc"><span class="type">GFreeFunc</span></a> destroy_notify</code></em>);</pre>
174
174
<p>
175
175
Creates a new Listener with the next available connection id and inserts it into the listener table.
176
176
The newly created listener listens for changes below and including the <em class="parameter"><code>listen_point.Returns</code></em> the newly
201
201
</tr>
202
202
<tr>
203
203
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
204
 
<td>the newly assigned connection id, a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> value.
 
204
<td>the newly assigned connection id, a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> value.
205
205
</td>
206
206
</tr>
207
207
</tbody>
211
211
<div class="refsect2" title="gconf_listeners_remove ()">
212
212
<a name="gconf-listeners-remove"></a><h3>gconf_listeners_remove ()</h3>
213
213
<pre class="programlisting"><span class="returnvalue">void</span>                gconf_listeners_remove              (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
214
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>);</pre>
 
214
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>);</pre>
215
215
<p>
216
216
Removes the listener from the listener table.
217
217
</p>
235
235
<div class="refsect2" title="gconf_listeners_notify ()">
236
236
<a name="gconf-listeners-notify"></a><h3>gconf_listeners_notify ()</h3>
237
237
<pre class="programlisting"><span class="returnvalue">void</span>                gconf_listeners_notify              (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
238
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *all_above</code></em>,
 
238
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *all_above</code></em>,
239
239
                                                         <em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListenersCallback" title="GConfListenersCallback ()"><span class="type">GConfListenersCallback</span></a> callback</code></em>,
240
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
240
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
241
241
<p>
242
242
Notifies all the associated listeners that a key has changed.
243
243
</p>
270
270
<hr>
271
271
<div class="refsect2" title="gconf_listeners_count ()">
272
272
<a name="gconf-listeners-count"></a><h3>gconf_listeners_count ()</h3>
273
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gconf_listeners_count               (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>);</pre>
 
273
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gconf_listeners_count               (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>);</pre>
274
274
<p>
275
275
Returns the number of alive listeners in the listener table.
276
276
</p>
295
295
<a name="gconf-listeners-foreach"></a><h3>gconf_listeners_foreach ()</h3>
296
296
<pre class="programlisting"><span class="returnvalue">void</span>                gconf_listeners_foreach             (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
297
297
                                                         <em class="parameter"><code><span class="type">GConfListenersForeach</span> callback</code></em>,
298
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
298
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
299
299
<p>
300
300
Execute a function for each of the <a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a>.
301
301
</p>
323
323
<hr>
324
324
<div class="refsect2" title="gconf_listeners_get_data ()">
325
325
<a name="gconf-listeners-get-data"></a><h3>gconf_listeners_get_data ()</h3>
326
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gconf_listeners_get_data            (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
327
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>,
328
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *listener_data_p</code></em>,
329
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **location_p</code></em>);</pre>
 
326
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gconf_listeners_get_data            (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
 
327
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> cnxn_id</code></em>,
 
328
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *listener_data_p</code></em>,
 
329
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **location_p</code></em>);</pre>
330
330
<p>
331
331
Obtains the data particular to a <span class="type">GConfListener</span>.
332
332
</p>
368
368
<a name="gconf-listeners-remove-if"></a><h3>gconf_listeners_remove_if ()</h3>
369
369
<pre class="programlisting"><span class="returnvalue">void</span>                gconf_listeners_remove_if           (<em class="parameter"><code><a class="link" href="gconf-gconf-listeners.html#GConfListeners" title="GConfListeners"><span class="type">GConfListeners</span></a> *listeners</code></em>,
370
370
                                                         <em class="parameter"><code><span class="type">GConfListenersPredicate</span> predicate</code></em>,
371
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
371
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
372
372
<p>
373
373
Remove the listener if a predicate is satisfied.
374
374
</p>
387
387
</tr>
388
388
<tr>
389
389
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
390
 
<td>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>.
 
390
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>.
391
391
</td>
392
392
</tr>
393
393
</tbody>