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>);
71
71
<div class="refsect1" title="Description">
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>
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.
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>
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
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>
331
331
Obtains the data particular to a <span class="type">GConfListener</span>.