~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed

« back to all changes in this revision

Viewing changes to docs/reference/gio/gdbus-object-manager-example/html/ExampleAnimal.html

  • Committer: Package Import Robot
  • Author(s): Andreas Henriksson
  • Date: 2014-03-24 20:58:34 UTC
  • mfrom: (1.66.13)
  • Revision ID: package-import@ubuntu.com-20140324205834-8hsgok8k36ftocqa
Tags: 2.40.0-1
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
47
47
<tbody>
48
48
<tr>
49
49
<td class="function_type">
50
 
<span class="returnvalue">GDBusInterfaceInfo</span> *
 
50
<a href="http://library.gnome.org/devel/gio/unstable/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="returnvalue">GDBusInterfaceInfo</span></a> *
51
51
</td>
52
52
<td class="function_name">
53
53
<a class="link" href="ExampleAnimal.html#example-animal-interface-info" title="example_animal_interface_info ()">example_animal_interface_info</a> <span class="c_punctuation">()</span>
55
55
</tr>
56
56
<tr>
57
57
<td class="function_type">
58
 
<span class="returnvalue">guint</span>
 
58
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
59
59
</td>
60
60
<td class="function_name">
61
61
<a class="link" href="ExampleAnimal.html#example-animal-override-properties" title="example_animal_override_properties ()">example_animal_override_properties</a> <span class="c_punctuation">()</span>
71
71
</tr>
72
72
<tr>
73
73
<td class="function_type">
74
 
<span class="returnvalue">gboolean</span>
 
74
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
75
75
</td>
76
76
<td class="function_name">
77
77
<a class="link" href="ExampleAnimal.html#example-animal-call-poke-finish" title="example_animal_call_poke_finish ()">example_animal_call_poke_finish</a> <span class="c_punctuation">()</span>
79
79
</tr>
80
80
<tr>
81
81
<td class="function_type">
82
 
<span class="returnvalue">gboolean</span>
 
82
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
83
83
</td>
84
84
<td class="function_name">
85
85
<a class="link" href="ExampleAnimal.html#example-animal-call-poke-sync" title="example_animal_call_poke_sync ()">example_animal_call_poke_sync</a> <span class="c_punctuation">()</span>
102
102
</td>
103
103
</tr>
104
104
<tr>
105
 
<td class="function_type">const <span class="returnvalue">gchar</span> *
 
105
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
106
106
</td>
107
107
<td class="function_name">
108
108
<a class="link" href="ExampleAnimal.html#example-animal-get-mood" title="example_animal_get_mood ()">example_animal_get_mood</a> <span class="c_punctuation">()</span>
109
109
</td>
110
110
</tr>
111
111
<tr>
112
 
<td class="function_type">const <span class="returnvalue">gchar</span> *
 
112
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
113
113
</td>
114
114
<td class="function_name">
115
115
<a class="link" href="ExampleAnimal.html#example-animal-get-foo" title="example_animal_get_foo ()">example_animal_get_foo</a> <span class="c_punctuation">()</span>
116
116
</td>
117
117
</tr>
118
118
<tr>
119
 
<td class="function_type">const <span class="returnvalue">gchar</span> *
 
119
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
120
120
</td>
121
121
<td class="function_name">
122
122
<a class="link" href="ExampleAnimal.html#example-animal-get-bar" title="example_animal_get_bar ()">example_animal_get_bar</a> <span class="c_punctuation">()</span>
124
124
</tr>
125
125
<tr>
126
126
<td class="function_type">
127
 
<span class="returnvalue">gchar</span> *
 
127
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
128
128
</td>
129
129
<td class="function_name">
130
130
<a class="link" href="ExampleAnimal.html#example-animal-dup-mood" title="example_animal_dup_mood ()">example_animal_dup_mood</a> <span class="c_punctuation">()</span>
132
132
</tr>
133
133
<tr>
134
134
<td class="function_type">
135
 
<span class="returnvalue">gchar</span> *
 
135
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
136
136
</td>
137
137
<td class="function_name">
138
138
<a class="link" href="ExampleAnimal.html#example-animal-dup-foo" title="example_animal_dup_foo ()">example_animal_dup_foo</a> <span class="c_punctuation">()</span>
140
140
</tr>
141
141
<tr>
142
142
<td class="function_type">
143
 
<span class="returnvalue">gchar</span> *
 
143
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
144
144
</td>
145
145
<td class="function_name">
146
146
<a class="link" href="ExampleAnimal.html#example-animal-dup-bar" title="example_animal_dup_bar ()">example_animal_dup_bar</a> <span class="c_punctuation">()</span>
240
240
<tbody>
241
241
<tr>
242
242
<td class="property_type">
243
 
<span class="type">gchar</span> *</td>
 
243
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
244
244
<td class="property_name"><a class="link" href="ExampleAnimal.html#ExampleAnimal--bar" title="The “bar” property">bar</a></td>
245
245
<td class="property_flags">Read / Write</td>
246
246
</tr>
247
247
<tr>
248
248
<td class="property_type">
249
 
<span class="type">gchar</span> *</td>
 
249
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
250
250
<td class="property_name"><a class="link" href="ExampleAnimal.html#ExampleAnimal--foo" title="The “foo” property">foo</a></td>
251
251
<td class="property_flags">Read / Write</td>
252
252
</tr>
253
253
<tr>
254
254
<td class="property_type">
255
 
<span class="type">gchar</span> *</td>
 
255
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
256
256
<td class="property_name"><a class="link" href="ExampleAnimal.html#ExampleAnimal--mood" title="The “mood” property">mood</a></td>
257
257
<td class="property_flags">Read / Write</td>
258
258
</tr>
269
269
</colgroup>
270
270
<tbody>
271
271
<tr>
272
 
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
 
272
<td class="signal_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
273
273
<td class="signal_name"><a class="link" href="ExampleAnimal.html#ExampleAnimal-handle-poke" title="The “handle-poke” signal">handle-poke</a></td>
274
 
<td class="signal_flags">Run Last</td>
 
274
<td class="signal_flags"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
275
275
</tr>
276
276
<tr>
277
277
<td class="signal_type"><span class="returnvalue">void</span></td>
278
278
<td class="signal_name"><a class="link" href="ExampleAnimal.html#ExampleAnimal-jumped" title="The “jumped” signal">jumped</a></td>
279
 
<td class="signal_flags">Run Last</td>
 
279
<td class="signal_flags"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
280
280
</tr>
281
281
</tbody>
282
282
</table></div>
318
318
</div>
319
319
<div class="refsect1">
320
320
<a name="ExampleAnimal.object-hierarchy"></a><h2>Object Hierarchy</h2>
321
 
<pre class="screen">    <a href="/home/desrt/.cache/jhbuild/install/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
 
321
<pre class="screen">    <a href="http://library.gnome.org/devel/gobject/unstable/GTypeModule.html">GInterface</a>
322
322
    <span class="lineart">╰──</span> ExampleAnimal
323
 
    GObject
324
 
    <span class="lineart">├──</span> GDBusInterfaceSkeleton
 
323
    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
324
    <span class="lineart">├──</span> <a href="http://library.gnome.org/devel/gio/unstable/GDBusInterfaceSkeleton.html">GDBusInterfaceSkeleton</a>
325
325
    <span class="lineart">│</span>   <span class="lineart">╰──</span> ExampleAnimalSkeleton
326
 
    <span class="lineart">╰──</span> GDBusProxy
 
326
    <span class="lineart">╰──</span> <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html">GDBusProxy</a>
327
327
        <span class="lineart">╰──</span> ExampleAnimalProxy
328
328
</pre>
329
329
</div>
331
331
<a name="ExampleAnimal.prerequisites"></a><h2>Prerequisites</h2>
332
332
<p>
333
333
ExampleAnimal requires
334
 
 GObject.</p>
 
334
 <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
335
335
</div>
336
336
<div class="refsect1">
337
337
<a name="ExampleAnimal.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
338
338
<p>
339
339
ExampleAnimalProxy implements
340
 
 GDBusInterface,  GInitable,  GAsyncInitable and  <a class="link" href="ExampleAnimal.html" title="ExampleAnimal">ExampleAnimal</a>.</p>
 
340
 <a href="http://library.gnome.org/devel/gio/unstable/GDBusInterface.html">GDBusInterface</a>,  <a href="http://library.gnome.org/devel/gio/unstable/GInitable.html">GInitable</a>,  <a href="http://library.gnome.org/devel/gio/unstable/GAsyncInitable.html">GAsyncInitable</a> and  <a class="link" href="ExampleAnimal.html" title="ExampleAnimal">ExampleAnimal</a>.</p>
341
341
<p>
342
342
ExampleAnimalSkeleton implements
343
 
 GDBusInterface and  <a class="link" href="ExampleAnimal.html" title="ExampleAnimal">ExampleAnimal</a>.</p>
 
343
 <a href="http://library.gnome.org/devel/gio/unstable/GDBusInterface.html">GDBusInterface</a> and  <a class="link" href="ExampleAnimal.html" title="ExampleAnimal">ExampleAnimal</a>.</p>
344
344
</div>
345
345
<div class="refsect1">
346
346
<a name="ExampleAnimal.implementations"></a><h2>Known Implementations</h2>
356
356
<a name="ExampleAnimal.functions_details"></a><h2>Functions</h2>
357
357
<div class="refsect2">
358
358
<a name="example-animal-interface-info"></a><h3>example_animal_interface_info ()</h3>
359
 
<pre class="programlisting"><span class="returnvalue">GDBusInterfaceInfo</span> *
 
359
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="returnvalue">GDBusInterfaceInfo</span></a> *
360
360
example_animal_interface_info (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
361
361
<p>Gets a machine-readable description of the org.gtk.GDBus.Example.ObjectManager.Animal D-Bus interface.</p>
362
362
<div class="refsect3">
363
363
<a name="id-1.1.2.2.14.2.5"></a><h4>Returns</h4>
364
 
<p> A <span class="type">GDBusInterfaceInfo</span>. Do not free. </p>
 
364
<p> A <a href="http://library.gnome.org/devel/gio/unstable/gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a>. Do not free. </p>
365
365
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span></p>
366
366
</div>
367
367
<p class="since">Since 2.30</p>
369
369
<hr>
370
370
<div class="refsect2">
371
371
<a name="example-animal-override-properties"></a><h3>example_animal_override_properties ()</h3>
372
 
<pre class="programlisting"><span class="returnvalue">guint</span>
373
 
example_animal_override_properties (<em class="parameter"><code><span class="type">GObjectClass</span> *klass</code></em>,
374
 
                                    <em class="parameter"><code><span class="type">guint</span> property_id_begin</code></em>);</pre>
375
 
<p>Overrides all <span class="type">GObject</span> properties in the <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> interface for a concrete class.
 
372
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
 
373
example_animal_override_properties (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *klass</code></em>,
 
374
                                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id_begin</code></em>);</pre>
 
375
<p>Overrides all <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> properties in the <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> interface for a concrete class.
376
376
The properties are overridden in the order they are defined.</p>
377
377
<div class="refsect3">
378
378
<a name="id-1.1.2.2.14.3.5"></a><h4>Parameters</h4>
385
385
<tbody>
386
386
<tr>
387
387
<td class="parameter_name"><p>klass</p></td>
388
 
<td class="parameter_description"><p>The class structure for a <span class="type">GObject</span>-derived class.</p></td>
 
388
<td class="parameter_description"><p>The class structure for a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>-derived class.</p></td>
389
389
<td class="parameter_annotations"> </td>
390
390
</tr>
391
391
<tr>
408
408
<a name="example-animal-call-poke"></a><h3>example_animal_call_poke ()</h3>
409
409
<pre class="programlisting"><span class="returnvalue">void</span>
410
410
example_animal_call_poke (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *proxy</code></em>,
411
 
                          <em class="parameter"><code><span class="type">gboolean</span> arg_make_sad</code></em>,
412
 
                          <em class="parameter"><code><span class="type">gboolean</span> arg_make_happy</code></em>,
413
 
                          <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
414
 
                          <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
415
 
                          <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
416
 
<p>Asynchronously invokes the <GTKDOCLINK HREF="Poke"><code class="function">Poke()</code></GTKDOCLINK> D-Bus method on <em class="parameter"><code>proxy</code></em>
 
411
                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_sad</code></em>,
 
412
                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_happy</code></em>,
 
413
                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 
414
                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 
415
                          <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>
 
416
<p>Asynchronously invokes the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke"><GTKDOCLINK HREF="Poke"><code class="function">Poke()</code></a></GTKDOCLINK> D-Bus method on <em class="parameter"><code>proxy</code></em>
417
417
.
418
418
When the operation is finished, <em class="parameter"><code>callback</code></em>
419
 
 will be invoked in the thread-default main loop of the thread you are calling this method from.
 
419
 will be invoked in the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
420
420
You can then call <a class="link" href="ExampleAnimal.html#example-animal-call-poke-finish" title="example_animal_call_poke_finish ()"><code class="function">example_animal_call_poke_finish()</code></a> to get the result of the operation.</p>
421
421
<p>See <a class="link" href="ExampleAnimal.html#example-animal-call-poke-sync" title="example_animal_call_poke_sync ()"><code class="function">example_animal_call_poke_sync()</code></a> for the synchronous, blocking version of this method.</p>
422
422
<div class="refsect3">
445
445
</tr>
446
446
<tr>
447
447
<td class="parameter_name"><p>cancellable</p></td>
448
 
<td class="parameter_description"><p> A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </p></td>
 
448
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
449
449
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
450
450
</tr>
451
451
<tr>
452
452
<td class="parameter_name"><p>callback</p></td>
453
 
<td class="parameter_description"><p>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied or <code class="literal">NULL</code>.</p></td>
 
453
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
454
454
<td class="parameter_annotations"> </td>
455
455
</tr>
456
456
<tr>
467
467
<hr>
468
468
<div class="refsect2">
469
469
<a name="example-animal-call-poke-finish"></a><h3>example_animal_call_poke_finish ()</h3>
470
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>
 
470
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
471
471
example_animal_call_poke_finish (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *proxy</code></em>,
472
 
                                 <em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
473
 
                                 <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
472
                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
 
473
                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
474
474
<p>Finishes an operation started with <a class="link" href="ExampleAnimal.html#example-animal-call-poke" title="example_animal_call_poke ()"><code class="function">example_animal_call_poke()</code></a>.</p>
475
475
<div class="refsect3">
476
476
<a name="id-1.1.2.2.14.5.5"></a><h4>Parameters</h4>
488
488
</tr>
489
489
<tr>
490
490
<td class="parameter_name"><p>res</p></td>
491
 
<td class="parameter_description"><p>The <span class="type">GAsyncResult</span> obtained from the <span class="type">GAsyncReadyCallback</span> passed to <a class="link" href="ExampleAnimal.html#example-animal-call-poke" title="example_animal_call_poke ()"><code class="function">example_animal_call_poke()</code></a>.</p></td>
 
491
<td class="parameter_description"><p>The <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="ExampleAnimal.html#example-animal-call-poke" title="example_animal_call_poke ()"><code class="function">example_animal_call_poke()</code></a>.</p></td>
492
492
<td class="parameter_annotations"> </td>
493
493
</tr>
494
494
<tr>
495
495
<td class="parameter_name"><p>error</p></td>
496
 
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>.</p></td>
 
496
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
497
497
<td class="parameter_annotations"> </td>
498
498
</tr>
499
499
</tbody>
501
501
</div>
502
502
<div class="refsect3">
503
503
<a name="id-1.1.2.2.14.5.6"></a><h4>Returns</h4>
504
 
<p> <code class="literal">TRUE</code> if the call succeded, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
 
504
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call succeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em>
505
505
is set. </p>
506
506
<p><span class="annotation">[<a href="http://foldoc.org/skip"><span class="acronym">skip</span></a>]</span></p>
507
507
</div>
510
510
<hr>
511
511
<div class="refsect2">
512
512
<a name="example-animal-call-poke-sync"></a><h3>example_animal_call_poke_sync ()</h3>
513
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>
 
513
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
514
514
example_animal_call_poke_sync (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *proxy</code></em>,
515
 
                               <em class="parameter"><code><span class="type">gboolean</span> arg_make_sad</code></em>,
516
 
                               <em class="parameter"><code><span class="type">gboolean</span> arg_make_happy</code></em>,
517
 
                               <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
518
 
                               <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
519
 
<p>Synchronously invokes the <GTKDOCLINK HREF="Poke"><code class="function">Poke()</code></GTKDOCLINK> D-Bus method on <em class="parameter"><code>proxy</code></em>
 
515
                               <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_sad</code></em>,
 
516
                               <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_happy</code></em>,
 
517
                               <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 
518
                               <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
519
<p>Synchronously invokes the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke"><GTKDOCLINK HREF="Poke"><code class="function">Poke()</code></a></GTKDOCLINK> D-Bus method on <em class="parameter"><code>proxy</code></em>
520
520
. The calling thread is blocked until a reply is received.</p>
521
521
<p>See <a class="link" href="ExampleAnimal.html#example-animal-call-poke" title="example_animal_call_poke ()"><code class="function">example_animal_call_poke()</code></a> for the asynchronous version of this method.</p>
522
522
<div class="refsect3">
545
545
</tr>
546
546
<tr>
547
547
<td class="parameter_name"><p>cancellable</p></td>
548
 
<td class="parameter_description"><p> A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </p></td>
 
548
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
549
549
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
550
550
</tr>
551
551
<tr>
552
552
<td class="parameter_name"><p>error</p></td>
553
 
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code>.</p></td>
 
553
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p></td>
554
554
<td class="parameter_annotations"> </td>
555
555
</tr>
556
556
</tbody>
558
558
</div>
559
559
<div class="refsect3">
560
560
<a name="id-1.1.2.2.14.6.7"></a><h4>Returns</h4>
561
 
<p> <code class="literal">TRUE</code> if the call succeded, <code class="literal">FALSE</code> if <em class="parameter"><code>error</code></em>
 
561
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call succeded, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em>
562
562
is set. </p>
563
563
<p><span class="annotation">[<a href="http://foldoc.org/skip"><span class="acronym">skip</span></a>]</span></p>
564
564
</div>
569
569
<a name="example-animal-complete-poke"></a><h3>example_animal_complete_poke ()</h3>
570
570
<pre class="programlisting"><span class="returnvalue">void</span>
571
571
example_animal_complete_poke (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>,
572
 
                              <em class="parameter"><code><span class="type">GDBusMethodInvocation</span> *invocation</code></em>);</pre>
573
 
<p>Helper function used in service implementations to finish handling invocations of the <GTKDOCLINK HREF="Poke"><code class="function">Poke()</code></GTKDOCLINK> D-Bus method. If you instead want to finish handling an invocation by returning an error, use <code class="function">g_dbus_method_invocation_return_error()</code> or similar.</p>
 
572
                              <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html"><span class="type">GDBusMethodInvocation</span></a> *invocation</code></em>);</pre>
 
573
<p>Helper function used in service implementations to finish handling invocations of the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke"><GTKDOCLINK HREF="Poke"><code class="function">Poke()</code></a></GTKDOCLINK> D-Bus method. If you instead want to finish handling an invocation by returning an error, use <a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html#g-dbus-method-invocation-return-error"><code class="function">g_dbus_method_invocation_return_error()</code></a> or similar.</p>
574
574
<p>This method will free <em class="parameter"><code>invocation</code></em>
575
575
, you cannot use it afterwards.</p>
576
576
<div class="refsect3">
589
589
</tr>
590
590
<tr>
591
591
<td class="parameter_name"><p>invocation</p></td>
592
 
<td class="parameter_description"><p> A <span class="type">GDBusMethodInvocation</span>. </p></td>
 
592
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html"><span class="type">GDBusMethodInvocation</span></a>. </p></td>
593
593
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></td>
594
594
</tr>
595
595
</tbody>
602
602
<a name="example-animal-emit-jumped"></a><h3>example_animal_emit_jumped ()</h3>
603
603
<pre class="programlisting"><span class="returnvalue">void</span>
604
604
example_animal_emit_jumped (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>,
605
 
                            <em class="parameter"><code><span class="type">gdouble</span> arg_height</code></em>);</pre>
606
 
<p>Emits the "Jumped" D-Bus signal.</p>
 
605
                            <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> arg_height</code></em>);</pre>
 
606
<p>Emits the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-signal-org-gtk-GDBus-Example-ObjectManager-Animal.Jumped">"Jumped"</a> D-Bus signal.</p>
607
607
<div class="refsect3">
608
608
<a name="id-1.1.2.2.14.8.5"></a><h4>Parameters</h4>
609
609
<div class="informaltable"><table width="100%" border="0">
631
631
<hr>
632
632
<div class="refsect2">
633
633
<a name="example-animal-get-mood"></a><h3>example_animal_get_mood ()</h3>
634
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
 
634
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
635
635
example_animal_get_mood (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>);</pre>
636
 
<p>Gets the value of the "Mood" D-Bus property.</p>
 
636
<p>Gets the value of the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood">"Mood"</a> D-Bus property.</p>
637
637
<p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
638
638
<div class="warning">The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where <em class="parameter"><code>object</code></em> was constructed. Use <a class="link" href="ExampleAnimal.html#example-animal-dup-mood" title="example_animal_dup_mood ()"><code class="function">example_animal_dup_mood()</code></a> if on another thread.</div>
639
639
<div class="refsect3">
653
653
</div>
654
654
<div class="refsect3">
655
655
<a name="id-1.1.2.2.14.9.8"></a><h4>Returns</h4>
656
 
<p> The property value or <code class="literal">NULL</code> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
 
656
<p> The property value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
657
657
. </p>
658
658
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span></p>
659
659
</div>
662
662
<hr>
663
663
<div class="refsect2">
664
664
<a name="example-animal-get-foo"></a><h3>example_animal_get_foo ()</h3>
665
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
 
665
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
666
666
example_animal_get_foo (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>);</pre>
667
 
<p>Gets the value of the "Foo" D-Bus property.</p>
 
667
<p>Gets the value of the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Foo">"Foo"</a> D-Bus property.</p>
668
668
<p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
669
669
<div class="warning">The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where <em class="parameter"><code>object</code></em> was constructed. Use <a class="link" href="ExampleAnimal.html#example-animal-dup-foo" title="example_animal_dup_foo ()"><code class="function">example_animal_dup_foo()</code></a> if on another thread.</div>
670
670
<div class="refsect3">
684
684
</div>
685
685
<div class="refsect3">
686
686
<a name="id-1.1.2.2.14.10.8"></a><h4>Returns</h4>
687
 
<p> The property value or <code class="literal">NULL</code> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
 
687
<p> The property value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
688
688
. </p>
689
689
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span></p>
690
690
</div>
693
693
<hr>
694
694
<div class="refsect2">
695
695
<a name="example-animal-get-bar"></a><h3>example_animal_get_bar ()</h3>
696
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
 
696
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
697
697
example_animal_get_bar (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>);</pre>
698
 
<p>Gets the value of the "Bar" D-Bus property.</p>
 
698
<p>Gets the value of the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Bar">"Bar"</a> D-Bus property.</p>
699
699
<p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
700
700
<div class="warning">The returned value is only valid until the property changes so on the client-side it is only safe to use this function on the thread where <em class="parameter"><code>object</code></em> was constructed. Use <a class="link" href="ExampleAnimal.html#example-animal-dup-bar" title="example_animal_dup_bar ()"><code class="function">example_animal_dup_bar()</code></a> if on another thread.</div>
701
701
<div class="refsect3">
715
715
</div>
716
716
<div class="refsect3">
717
717
<a name="id-1.1.2.2.14.11.8"></a><h4>Returns</h4>
718
 
<p> The property value or <code class="literal">NULL</code> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
 
718
<p> The property value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. Do not free the returned value, it belongs to <em class="parameter"><code>object</code></em>
719
719
. </p>
720
720
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span></p>
721
721
</div>
724
724
<hr>
725
725
<div class="refsect2">
726
726
<a name="example-animal-dup-mood"></a><h3>example_animal_dup_mood ()</h3>
727
 
<pre class="programlisting"><span class="returnvalue">gchar</span> *
 
727
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
728
728
example_animal_dup_mood (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>);</pre>
729
 
<p>Gets a copy of the "Mood" D-Bus property.</p>
 
729
<p>Gets a copy of the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood">"Mood"</a> D-Bus property.</p>
730
730
<p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
731
731
<div class="refsect3">
732
732
<a name="id-1.1.2.2.14.12.6"></a><h4>Parameters</h4>
745
745
</div>
746
746
<div class="refsect3">
747
747
<a name="id-1.1.2.2.14.12.7"></a><h4>Returns</h4>
748
 
<p> The property value or <code class="literal">NULL</code> if the property is not set. The returned value should be freed with <code class="function">g_free()</code>. </p>
 
748
<p> The property value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. The returned value should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
749
749
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></p>
750
750
</div>
751
751
<p class="since">Since 2.30</p>
753
753
<hr>
754
754
<div class="refsect2">
755
755
<a name="example-animal-dup-foo"></a><h3>example_animal_dup_foo ()</h3>
756
 
<pre class="programlisting"><span class="returnvalue">gchar</span> *
 
756
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
757
757
example_animal_dup_foo (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>);</pre>
758
 
<p>Gets a copy of the "Foo" D-Bus property.</p>
 
758
<p>Gets a copy of the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Foo">"Foo"</a> D-Bus property.</p>
759
759
<p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
760
760
<div class="refsect3">
761
761
<a name="id-1.1.2.2.14.13.6"></a><h4>Parameters</h4>
774
774
</div>
775
775
<div class="refsect3">
776
776
<a name="id-1.1.2.2.14.13.7"></a><h4>Returns</h4>
777
 
<p> The property value or <code class="literal">NULL</code> if the property is not set. The returned value should be freed with <code class="function">g_free()</code>. </p>
 
777
<p> The property value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. The returned value should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
778
778
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></p>
779
779
</div>
780
780
<p class="since">Since 2.30</p>
782
782
<hr>
783
783
<div class="refsect2">
784
784
<a name="example-animal-dup-bar"></a><h3>example_animal_dup_bar ()</h3>
785
 
<pre class="programlisting"><span class="returnvalue">gchar</span> *
 
785
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
786
786
example_animal_dup_bar (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>);</pre>
787
 
<p>Gets a copy of the "Bar" D-Bus property.</p>
 
787
<p>Gets a copy of the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Bar">"Bar"</a> D-Bus property.</p>
788
788
<p>Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.</p>
789
789
<div class="refsect3">
790
790
<a name="id-1.1.2.2.14.14.6"></a><h4>Parameters</h4>
803
803
</div>
804
804
<div class="refsect3">
805
805
<a name="id-1.1.2.2.14.14.7"></a><h4>Returns</h4>
806
 
<p> The property value or <code class="literal">NULL</code> if the property is not set. The returned value should be freed with <code class="function">g_free()</code>. </p>
 
806
<p> The property value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the property is not set. The returned value should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
807
807
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></p>
808
808
</div>
809
809
<p class="since">Since 2.36</p>
813
813
<a name="example-animal-set-mood"></a><h3>example_animal_set_mood ()</h3>
814
814
<pre class="programlisting"><span class="returnvalue">void</span>
815
815
example_animal_set_mood (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>,
816
 
                         <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
817
 
<p>Sets the "Mood" D-Bus property to <em class="parameter"><code>value</code></em>
 
816
                         <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> *value</code></em>);</pre>
 
817
<p>Sets the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood">"Mood"</a> D-Bus property to <em class="parameter"><code>value</code></em>
818
818
.</p>
819
819
<p>Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.</p>
820
820
<div class="refsect3">
846
846
<a name="example-animal-set-foo"></a><h3>example_animal_set_foo ()</h3>
847
847
<pre class="programlisting"><span class="returnvalue">void</span>
848
848
example_animal_set_foo (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>,
849
 
                        <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
850
 
<p>Sets the "Foo" D-Bus property to <em class="parameter"><code>value</code></em>
 
849
                        <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> *value</code></em>);</pre>
 
850
<p>Sets the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Foo">"Foo"</a> D-Bus property to <em class="parameter"><code>value</code></em>
851
851
.</p>
852
852
<p>Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.</p>
853
853
<div class="refsect3">
879
879
<a name="example-animal-set-bar"></a><h3>example_animal_set_bar ()</h3>
880
880
<pre class="programlisting"><span class="returnvalue">void</span>
881
881
example_animal_set_bar (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>,
882
 
                        <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
883
 
<p>Sets the "Bar" D-Bus property to <em class="parameter"><code>value</code></em>
 
882
                        <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> *value</code></em>);</pre>
 
883
<p>Sets the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Bar">"Bar"</a> D-Bus property to <em class="parameter"><code>value</code></em>
884
884
.</p>
885
885
<p>Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.</p>
886
886
<div class="refsect3">
911
911
<div class="refsect2">
912
912
<a name="example-animal-proxy-new"></a><h3>example_animal_proxy_new ()</h3>
913
913
<pre class="programlisting"><span class="returnvalue">void</span>
914
 
example_animal_proxy_new (<em class="parameter"><code><span class="type">GDBusConnection</span> *connection</code></em>,
915
 
                          <em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
916
 
                          <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
917
 
                          <em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
918
 
                          <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
919
 
                          <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
920
 
                          <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
921
 
<p>Asynchronously creates a proxy for the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Animal. See <code class="function">g_dbus_proxy_new()</code> for more details.</p>
 
914
example_animal_proxy_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
 
915
                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
 
916
                          <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> *name</code></em>,
 
917
                          <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> *object_path</code></em>,
 
918
                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 
919
                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 
920
                          <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>
 
921
<p>Asynchronously creates a proxy for the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Animal. See <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#g-dbus-proxy-new"><code class="function">g_dbus_proxy_new()</code></a> for more details.</p>
922
922
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
923
 
 will be invoked in the thread-default main loop of the thread you are calling this method from.
 
923
 will be invoked in the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
924
924
You can then call <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-finish" title="example_animal_proxy_new_finish ()"><code class="function">example_animal_proxy_new_finish()</code></a> to get the result of the operation.</p>
925
925
<p>See <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-sync" title="example_animal_proxy_new_sync ()"><code class="function">example_animal_proxy_new_sync()</code></a> for the synchronous, blocking version of this constructor.</p>
926
926
<div class="refsect3">
934
934
<tbody>
935
935
<tr>
936
936
<td class="parameter_name"><p>connection</p></td>
937
 
<td class="parameter_description"><p>A <span class="type">GDBusConnection</span>.</p></td>
 
937
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</p></td>
938
938
<td class="parameter_annotations"> </td>
939
939
</tr>
940
940
<tr>
941
941
<td class="parameter_name"><p>flags</p></td>
942
 
<td class="parameter_description"><p>Flags from the <span class="type">GDBusProxyFlags</span> enumeration.</p></td>
 
942
<td class="parameter_description"><p>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
943
943
<td class="parameter_annotations"> </td>
944
944
</tr>
945
945
<tr>
946
946
<td class="parameter_name"><p>name</p></td>
947
 
<td class="parameter_description"><p> A bus name (well-known or unique) or <code class="literal">NULL</code> if <em class="parameter"><code>connection</code></em>
 
947
<td class="parameter_description"><p> A bus name (well-known or unique) or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em>
948
948
is not a message bus connection. </p></td>
949
949
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
950
950
</tr>
955
955
</tr>
956
956
<tr>
957
957
<td class="parameter_name"><p>cancellable</p></td>
958
 
<td class="parameter_description"><p> A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </p></td>
 
958
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
959
959
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
960
960
</tr>
961
961
<tr>
962
962
<td class="parameter_name"><p>callback</p></td>
963
 
<td class="parameter_description"><p>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
 
963
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</p></td>
964
964
<td class="parameter_annotations"> </td>
965
965
</tr>
966
966
<tr>
978
978
<div class="refsect2">
979
979
<a name="example-animal-proxy-new-finish"></a><h3>example_animal_proxy_new_finish ()</h3>
980
980
<pre class="programlisting"><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> *
981
 
example_animal_proxy_new_finish (<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
982
 
                                 <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
981
example_animal_proxy_new_finish (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
 
982
                                 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
983
983
<p>Finishes an operation started with <a class="link" href="ExampleAnimal.html#example-animal-proxy-new" title="example_animal_proxy_new ()"><code class="function">example_animal_proxy_new()</code></a>.</p>
984
984
<div class="refsect3">
985
985
<a name="id-1.1.2.2.14.19.5"></a><h4>Parameters</h4>
992
992
<tbody>
993
993
<tr>
994
994
<td class="parameter_name"><p>res</p></td>
995
 
<td class="parameter_description"><p>The <span class="type">GAsyncResult</span> obtained from the <span class="type">GAsyncReadyCallback</span> passed to <a class="link" href="ExampleAnimal.html#example-animal-proxy-new" title="example_animal_proxy_new ()"><code class="function">example_animal_proxy_new()</code></a>.</p></td>
 
995
<td class="parameter_description"><p>The <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="ExampleAnimal.html#example-animal-proxy-new" title="example_animal_proxy_new ()"><code class="function">example_animal_proxy_new()</code></a>.</p></td>
996
996
<td class="parameter_annotations"> </td>
997
997
</tr>
998
998
<tr>
999
999
<td class="parameter_name"><p>error</p></td>
1000
 
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code></p></td>
 
1000
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1001
1001
<td class="parameter_annotations"> </td>
1002
1002
</tr>
1003
1003
</tbody>
1005
1005
</div>
1006
1006
<div class="refsect3">
1007
1007
<a name="id-1.1.2.2.14.19.6"></a><h4>Returns</h4>
1008
 
<p> The constructed proxy object or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em>
 
1008
<p> The constructed proxy object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
1009
1009
is set. </p>
1010
1010
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>][<a href="http://foldoc.org/type"><span class="acronym">type</span></a> ExampleAnimalProxy]</span></p>
1011
1011
</div>
1015
1015
<div class="refsect2">
1016
1016
<a name="example-animal-proxy-new-sync"></a><h3>example_animal_proxy_new_sync ()</h3>
1017
1017
<pre class="programlisting"><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> *
1018
 
example_animal_proxy_new_sync (<em class="parameter"><code><span class="type">GDBusConnection</span> *connection</code></em>,
1019
 
                               <em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
1020
 
                               <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
1021
 
                               <em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
1022
 
                               <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
1023
 
                               <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
1024
 
<p>Synchronously creates a proxy for the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Animal. See <code class="function">g_dbus_proxy_new_sync()</code> for more details.</p>
 
1018
example_animal_proxy_new_sync (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
 
1019
                               <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
 
1020
                               <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> *name</code></em>,
 
1021
                               <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> *object_path</code></em>,
 
1022
                               <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 
1023
                               <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
1024
<p>Synchronously creates a proxy for the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Animal. See <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#g-dbus-proxy-new-sync"><code class="function">g_dbus_proxy_new_sync()</code></a> for more details.</p>
1025
1025
<p>The calling thread is blocked until a reply is received.</p>
1026
1026
<p>See <a class="link" href="ExampleAnimal.html#example-animal-proxy-new" title="example_animal_proxy_new ()"><code class="function">example_animal_proxy_new()</code></a> for the asynchronous version of this constructor.</p>
1027
1027
<div class="refsect3">
1035
1035
<tbody>
1036
1036
<tr>
1037
1037
<td class="parameter_name"><p>connection</p></td>
1038
 
<td class="parameter_description"><p>A <span class="type">GDBusConnection</span>.</p></td>
 
1038
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</p></td>
1039
1039
<td class="parameter_annotations"> </td>
1040
1040
</tr>
1041
1041
<tr>
1042
1042
<td class="parameter_name"><p>flags</p></td>
1043
 
<td class="parameter_description"><p>Flags from the <span class="type">GDBusProxyFlags</span> enumeration.</p></td>
 
1043
<td class="parameter_description"><p>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
1044
1044
<td class="parameter_annotations"> </td>
1045
1045
</tr>
1046
1046
<tr>
1047
1047
<td class="parameter_name"><p>name</p></td>
1048
 
<td class="parameter_description"><p> A bus name (well-known or unique) or <code class="literal">NULL</code> if <em class="parameter"><code>connection</code></em>
 
1048
<td class="parameter_description"><p> A bus name (well-known or unique) or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em>
1049
1049
is not a message bus connection. </p></td>
1050
1050
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
1051
1051
</tr>
1056
1056
</tr>
1057
1057
<tr>
1058
1058
<td class="parameter_name"><p>cancellable</p></td>
1059
 
<td class="parameter_description"><p> A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </p></td>
 
1059
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1060
1060
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
1061
1061
</tr>
1062
1062
<tr>
1063
1063
<td class="parameter_name"><p>error</p></td>
1064
 
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code></p></td>
 
1064
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1065
1065
<td class="parameter_annotations"> </td>
1066
1066
</tr>
1067
1067
</tbody>
1069
1069
</div>
1070
1070
<div class="refsect3">
1071
1071
<a name="id-1.1.2.2.14.20.8"></a><h4>Returns</h4>
1072
 
<p> The constructed proxy object or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em>
 
1072
<p> The constructed proxy object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
1073
1073
is set. </p>
1074
1074
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>][<a href="http://foldoc.org/type"><span class="acronym">type</span></a> ExampleAnimalProxy]</span></p>
1075
1075
</div>
1079
1079
<div class="refsect2">
1080
1080
<a name="example-animal-proxy-new-for-bus"></a><h3>example_animal_proxy_new_for_bus ()</h3>
1081
1081
<pre class="programlisting"><span class="returnvalue">void</span>
1082
 
example_animal_proxy_new_for_bus (<em class="parameter"><code><span class="type">GBusType</span> bus_type</code></em>,
1083
 
                                  <em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
1084
 
                                  <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
1085
 
                                  <em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
1086
 
                                  <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
1087
 
                                  <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
1088
 
                                  <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
1089
 
<p>Like <a class="link" href="ExampleAnimal.html#example-animal-proxy-new" title="example_animal_proxy_new ()"><code class="function">example_animal_proxy_new()</code></a> but takes a <span class="type">GBusType</span> instead of a <span class="type">GDBusConnection</span>.</p>
 
1082
example_animal_proxy_new_for_bus (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
 
1083
                                  <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
 
1084
                                  <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> *name</code></em>,
 
1085
                                  <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> *object_path</code></em>,
 
1086
                                  <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 
1087
                                  <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 
1088
                                  <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>
 
1089
<p>Like <a class="link" href="ExampleAnimal.html#example-animal-proxy-new" title="example_animal_proxy_new ()"><code class="function">example_animal_proxy_new()</code></a> but takes a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> instead of a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</p>
1090
1090
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
1091
 
 will be invoked in the thread-default main loop of the thread you are calling this method from.
 
1091
 will be invoked in the <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
1092
1092
You can then call <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-for-bus-finish" title="example_animal_proxy_new_for_bus_finish ()"><code class="function">example_animal_proxy_new_for_bus_finish()</code></a> to get the result of the operation.</p>
1093
1093
<p>See <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-for-bus-sync" title="example_animal_proxy_new_for_bus_sync ()"><code class="function">example_animal_proxy_new_for_bus_sync()</code></a> for the synchronous, blocking version of this constructor.</p>
1094
1094
<div class="refsect3">
1102
1102
<tbody>
1103
1103
<tr>
1104
1104
<td class="parameter_name"><p>bus_type</p></td>
1105
 
<td class="parameter_description"><p>A <span class="type">GBusType</span>.</p></td>
 
1105
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a>.</p></td>
1106
1106
<td class="parameter_annotations"> </td>
1107
1107
</tr>
1108
1108
<tr>
1109
1109
<td class="parameter_name"><p>flags</p></td>
1110
 
<td class="parameter_description"><p>Flags from the <span class="type">GDBusProxyFlags</span> enumeration.</p></td>
 
1110
<td class="parameter_description"><p>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
1111
1111
<td class="parameter_annotations"> </td>
1112
1112
</tr>
1113
1113
<tr>
1122
1122
</tr>
1123
1123
<tr>
1124
1124
<td class="parameter_name"><p>cancellable</p></td>
1125
 
<td class="parameter_description"><p> A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </p></td>
 
1125
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1126
1126
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
1127
1127
</tr>
1128
1128
<tr>
1129
1129
<td class="parameter_name"><p>callback</p></td>
1130
 
<td class="parameter_description"><p>A <span class="type">GAsyncReadyCallback</span> to call when the request is satisfied.</p></td>
 
1130
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</p></td>
1131
1131
<td class="parameter_annotations"> </td>
1132
1132
</tr>
1133
1133
<tr>
1146
1146
<a name="example-animal-proxy-new-for-bus-finish"></a><h3>example_animal_proxy_new_for_bus_finish ()</h3>
1147
1147
<pre class="programlisting"><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> *
1148
1148
example_animal_proxy_new_for_bus_finish
1149
 
                               (<em class="parameter"><code><span class="type">GAsyncResult</span> *res</code></em>,
1150
 
                                <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
1149
                               (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
 
1150
                                <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1151
1151
<p>Finishes an operation started with <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-for-bus" title="example_animal_proxy_new_for_bus ()"><code class="function">example_animal_proxy_new_for_bus()</code></a>.</p>
1152
1152
<div class="refsect3">
1153
1153
<a name="id-1.1.2.2.14.22.5"></a><h4>Parameters</h4>
1160
1160
<tbody>
1161
1161
<tr>
1162
1162
<td class="parameter_name"><p>res</p></td>
1163
 
<td class="parameter_description"><p>The <span class="type">GAsyncResult</span> obtained from the <span class="type">GAsyncReadyCallback</span> passed to <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-for-bus" title="example_animal_proxy_new_for_bus ()"><code class="function">example_animal_proxy_new_for_bus()</code></a>.</p></td>
 
1163
<td class="parameter_description"><p>The <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-for-bus" title="example_animal_proxy_new_for_bus ()"><code class="function">example_animal_proxy_new_for_bus()</code></a>.</p></td>
1164
1164
<td class="parameter_annotations"> </td>
1165
1165
</tr>
1166
1166
<tr>
1167
1167
<td class="parameter_name"><p>error</p></td>
1168
 
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code></p></td>
 
1168
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1169
1169
<td class="parameter_annotations"> </td>
1170
1170
</tr>
1171
1171
</tbody>
1173
1173
</div>
1174
1174
<div class="refsect3">
1175
1175
<a name="id-1.1.2.2.14.22.6"></a><h4>Returns</h4>
1176
 
<p> The constructed proxy object or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em>
 
1176
<p> The constructed proxy object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
1177
1177
is set. </p>
1178
1178
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>][<a href="http://foldoc.org/type"><span class="acronym">type</span></a> ExampleAnimalProxy]</span></p>
1179
1179
</div>
1183
1183
<div class="refsect2">
1184
1184
<a name="example-animal-proxy-new-for-bus-sync"></a><h3>example_animal_proxy_new_for_bus_sync ()</h3>
1185
1185
<pre class="programlisting"><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> *
1186
 
example_animal_proxy_new_for_bus_sync (<em class="parameter"><code><span class="type">GBusType</span> bus_type</code></em>,
1187
 
                                       <em class="parameter"><code><span class="type">GDBusProxyFlags</span> flags</code></em>,
1188
 
                                       <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
1189
 
                                       <em class="parameter"><code>const <span class="type">gchar</span> *object_path</code></em>,
1190
 
                                       <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
1191
 
                                       <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
1192
 
<p>Like <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-sync" title="example_animal_proxy_new_sync ()"><code class="function">example_animal_proxy_new_sync()</code></a> but takes a <span class="type">GBusType</span> instead of a <span class="type">GDBusConnection</span>.</p>
 
1186
example_animal_proxy_new_for_bus_sync (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
 
1187
                                       <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
 
1188
                                       <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> *name</code></em>,
 
1189
                                       <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> *object_path</code></em>,
 
1190
                                       <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 
1191
                                       <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
1192
<p>Like <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-sync" title="example_animal_proxy_new_sync ()"><code class="function">example_animal_proxy_new_sync()</code></a> but takes a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> instead of a <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</p>
1193
1193
<p>The calling thread is blocked until a reply is received.</p>
1194
1194
<p>See <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-for-bus" title="example_animal_proxy_new_for_bus ()"><code class="function">example_animal_proxy_new_for_bus()</code></a> for the asynchronous version of this constructor.</p>
1195
1195
<div class="refsect3">
1203
1203
<tbody>
1204
1204
<tr>
1205
1205
<td class="parameter_name"><p>bus_type</p></td>
1206
 
<td class="parameter_description"><p>A <span class="type">GBusType</span>.</p></td>
 
1206
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a>.</p></td>
1207
1207
<td class="parameter_annotations"> </td>
1208
1208
</tr>
1209
1209
<tr>
1210
1210
<td class="parameter_name"><p>flags</p></td>
1211
 
<td class="parameter_description"><p>Flags from the <span class="type">GDBusProxyFlags</span> enumeration.</p></td>
 
1211
<td class="parameter_description"><p>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</p></td>
1212
1212
<td class="parameter_annotations"> </td>
1213
1213
</tr>
1214
1214
<tr>
1223
1223
</tr>
1224
1224
<tr>
1225
1225
<td class="parameter_name"><p>cancellable</p></td>
1226
 
<td class="parameter_description"><p> A <span class="type">GCancellable</span> or <code class="literal">NULL</code>. </p></td>
 
1226
<td class="parameter_description"><p> A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1227
1227
<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
1228
1228
</tr>
1229
1229
<tr>
1230
1230
<td class="parameter_name"><p>error</p></td>
1231
 
<td class="parameter_description"><p>Return location for error or <code class="literal">NULL</code></p></td>
 
1231
<td class="parameter_description"><p>Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1232
1232
<td class="parameter_annotations"> </td>
1233
1233
</tr>
1234
1234
</tbody>
1236
1236
</div>
1237
1237
<div class="refsect3">
1238
1238
<a name="id-1.1.2.2.14.23.8"></a><h4>Returns</h4>
1239
 
<p> The constructed proxy object or <code class="literal">NULL</code> if <em class="parameter"><code>error</code></em>
 
1239
<p> The constructed proxy object or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em>
1240
1240
is set. </p>
1241
1241
<p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>][<a href="http://foldoc.org/type"><span class="acronym">type</span></a> ExampleAnimalProxy]</span></p>
1242
1242
</div>
1300
1300
</colgroup>
1301
1301
<tbody>
1302
1302
<tr>
1303
 
<td class="struct_member_name"><p><span class="type">GTypeInterface</span> <em class="structfield"><code><a name="ExampleAnimalIface.parent-iface"></a>parent_iface</code></em>;</p></td>
 
1303
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="ExampleAnimalIface.parent-iface"></a>parent_iface</code></em>;</p></td>
1304
1304
<td class="struct_member_description"><p>The parent interface.</p></td>
1305
1305
<td class="struct_member_annotations"> </td>
1306
1306
</tr>
1358
1358
<col width="200px" class="struct_members_annotations">
1359
1359
</colgroup>
1360
1360
<tbody><tr>
1361
 
<td class="struct_member_name"><p><span class="type">GDBusProxyClass</span> <em class="structfield"><code><a name="ExampleAnimalProxyClass.parent-class"></a>parent_class</code></em>;</p></td>
 
1361
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyClass"><span class="type">GDBusProxyClass</span></a> <em class="structfield"><code><a name="ExampleAnimalProxyClass.parent-class"></a>parent_class</code></em>;</p></td>
1362
1362
<td class="struct_member_description"><p>The parent class.</p></td>
1363
1363
<td class="struct_member_annotations"> </td>
1364
1364
</tr></tbody>
1390
1390
<col width="200px" class="struct_members_annotations">
1391
1391
</colgroup>
1392
1392
<tbody><tr>
1393
 
<td class="struct_member_name"><p><span class="type">GDBusInterfaceSkeletonClass</span> <em class="structfield"><code><a name="ExampleAnimalSkeletonClass.parent-class"></a>parent_class</code></em>;</p></td>
 
1393
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/gio/unstable/GDBusInterfaceSkeleton.html#GDBusInterfaceSkeletonClass"><span class="type">GDBusInterfaceSkeletonClass</span></a> <em class="structfield"><code><a name="ExampleAnimalSkeletonClass.parent-class"></a>parent_class</code></em>;</p></td>
1394
1394
<td class="struct_member_description"><p>The parent class.</p></td>
1395
1395
<td class="struct_member_annotations"> </td>
1396
1396
</tr></tbody>
1403
1403
<a name="ExampleAnimal.property-details"></a><h2>Property Details</h2>
1404
1404
<div class="refsect2">
1405
1405
<a name="ExampleAnimal--bar"></a><h3>The <code class="literal">“bar”</code> property</h3>
1406
 
<pre class="programlisting">  “bar”                      <span class="type">gchar</span> *</pre>
1407
 
<p>Represents the D-Bus property "Bar".</p>
1408
 
<p>Since the D-Bus property for this <span class="type">GObject</span> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.</p>
 
1406
<pre class="programlisting">  “bar”                      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
 
1407
<p>Represents the D-Bus property <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Bar">"Bar"</a>.</p>
 
1408
<p>Since the D-Bus property for this <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.</p>
1409
1409
<p>Flags: Read / Write</p>
1410
1410
<p>Default value: NULL</p>
1411
1411
<p class="since">Since 2.36</p>
1413
1413
<hr>
1414
1414
<div class="refsect2">
1415
1415
<a name="ExampleAnimal--foo"></a><h3>The <code class="literal">“foo”</code> property</h3>
1416
 
<pre class="programlisting">  “foo”                      <span class="type">gchar</span> *</pre>
1417
 
<p>Represents the D-Bus property "Foo".</p>
1418
 
<p>Since the D-Bus property for this <span class="type">GObject</span> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.</p>
 
1416
<pre class="programlisting">  “foo”                      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
 
1417
<p>Represents the D-Bus property <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Foo">"Foo"</a>.</p>
 
1418
<p>Since the D-Bus property for this <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.</p>
1419
1419
<p>Flags: Read / Write</p>
1420
1420
<p>Default value: NULL</p>
1421
1421
<p class="since">Since 2.30</p>
1423
1423
<hr>
1424
1424
<div class="refsect2">
1425
1425
<a name="ExampleAnimal--mood"></a><h3>The <code class="literal">“mood”</code> property</h3>
1426
 
<pre class="programlisting">  “mood”                     <span class="type">gchar</span> *</pre>
1427
 
<p>Represents the D-Bus property "Mood".</p>
1428
 
<p>Since the D-Bus property for this <span class="type">GObject</span> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.</p>
 
1426
<pre class="programlisting">  “mood”                     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
 
1427
<p>Represents the D-Bus property <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood">"Mood"</a>.</p>
 
1428
<p>Since the D-Bus property for this <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> property is readable but not writable, it is meaningful to read from it on both the client- and service-side. It is only meaningful, however, to write to it on the service-side.</p>
1429
1429
<p>Flags: Read / Write</p>
1430
1430
<p>Default value: NULL</p>
1431
1431
<p class="since">Since 2.30</p>
1435
1435
<a name="ExampleAnimal.signal-details"></a><h2>Signal Details</h2>
1436
1436
<div class="refsect2">
1437
1437
<a name="ExampleAnimal-handle-poke"></a><h3>The <code class="literal">“handle-poke”</code> signal</h3>
1438
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>
 
1438
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1439
1439
user_function (<a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a>         *object,
1440
 
               <span class="type">GDBusMethodInvocation</span> *invocation,
1441
 
               <span class="type">gboolean</span>               arg_make_sad,
1442
 
               <span class="type">gboolean</span>               arg_make_happy,
1443
 
               <span class="type">gpointer</span>               user_data)</pre>
1444
 
<p>Signal emitted when a remote caller is invoking the <GTKDOCLINK HREF="Poke"><code class="function">Poke()</code></GTKDOCLINK> D-Bus method.</p>
1445
 
<p>If a signal handler returns <code class="literal">TRUE</code>, it means the signal handler will handle the invocation (e.g. take a reference to <em class="parameter"><code>invocation</code></em>
1446
 
 and eventually call <a class="link" href="ExampleAnimal.html#example-animal-complete-poke" title="example_animal_complete_poke ()"><code class="function">example_animal_complete_poke()</code></a> or e.g. <code class="function">g_dbus_method_invocation_return_error()</code> on it) and no order signal handlers will run. If no signal handler handles the invocation, the <code class="literal">G_DBUS_ERROR_UNKNOWN_METHOD</code> error is returned.</p>
 
1440
               <a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html"><span class="type">GDBusMethodInvocation</span></a> *invocation,
 
1441
               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>               arg_make_sad,
 
1442
               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>               arg_make_happy,
 
1443
               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>               user_data)</pre>
 
1444
<p>Signal emitted when a remote caller is invoking the <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke"><GTKDOCLINK HREF="Poke"><code class="function">Poke()</code></a></GTKDOCLINK> D-Bus method.</p>
 
1445
<p>If a signal handler returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, it means the signal handler will handle the invocation (e.g. take a reference to <em class="parameter"><code>invocation</code></em>
 
1446
 and eventually call <a class="link" href="ExampleAnimal.html#example-animal-complete-poke" title="example_animal_complete_poke ()"><code class="function">example_animal_complete_poke()</code></a> or e.g. <a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html#g-dbus-method-invocation-return-error"><code class="function">g_dbus_method_invocation_return_error()</code></a> on it) and no order signal handlers will run. If no signal handler handles the invocation, the <a href="http://library.gnome.org/devel/gio/unstable/gio-GDBusError.html#G-DBUS-ERROR-UNKNOWN-METHOD:CAPS"><code class="literal">G_DBUS_ERROR_UNKNOWN_METHOD</code></a> error is returned.</p>
1447
1447
<div class="refsect3">
1448
1448
<a name="id-1.1.2.2.17.2.6"></a><h4>Parameters</h4>
1449
1449
<div class="informaltable"><table width="100%" border="0">
1460
1460
</tr>
1461
1461
<tr>
1462
1462
<td class="parameter_name"><p>invocation</p></td>
1463
 
<td class="parameter_description"><p>A <span class="type">GDBusMethodInvocation</span>.</p></td>
 
1463
<td class="parameter_description"><p>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html"><span class="type">GDBusMethodInvocation</span></a>.</p></td>
1464
1464
<td class="parameter_annotations"> </td>
1465
1465
</tr>
1466
1466
<tr>
1483
1483
</div>
1484
1484
<div class="refsect3">
1485
1485
<a name="id-1.1.2.2.17.2.7"></a><h4>Returns</h4>
1486
 
<p> <code class="literal">TRUE</code> if the invocation was handled, <code class="literal">FALSE</code> to let other signal handlers run.</p>
 
1486
<p> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the invocation was handled, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let other signal handlers run.</p>
1487
1487
<p></p>
1488
1488
</div>
1489
 
<p>Flags: Run Last</p>
 
1489
<p>Flags: <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
1490
1490
<p class="since">Since 2.30</p>
1491
1491
</div>
1492
1492
<hr>
1494
1494
<a name="ExampleAnimal-jumped"></a><h3>The <code class="literal">“jumped”</code> signal</h3>
1495
1495
<pre class="programlisting"><span class="returnvalue">void</span>
1496
1496
user_function (<a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object,
1497
 
               <span class="type">gdouble</span>        arg_height,
1498
 
               <span class="type">gpointer</span>       user_data)</pre>
1499
 
<p>On the client-side, this signal is emitted whenever the D-Bus signal "Jumped" is received.</p>
1500
 
<p>On the service-side, this signal can be used with e.g. <code class="function">g_signal_emit_by_name()</code> to make the object emit the D-Bus signal.</p>
 
1497
               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a>        arg_height,
 
1498
               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)</pre>
 
1499
<p>On the client-side, this signal is emitted whenever the D-Bus signal <a href="http://library.gnome.org/devel/gio/unstable/gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-signal-org-gtk-GDBus-Example-ObjectManager-Animal.Jumped">"Jumped"</a> is received.</p>
 
1500
<p>On the service-side, this signal can be used with e.g. <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> to make the object emit the D-Bus signal.</p>
1501
1501
<div class="refsect3">
1502
1502
<a name="id-1.1.2.2.17.3.6"></a><h4>Parameters</h4>
1503
1503
<div class="informaltable"><table width="100%" border="0">
1525
1525
</tbody>
1526
1526
</table></div>
1527
1527
</div>
1528
 
<p>Flags: Run Last</p>
 
1528
<p>Flags: <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
1529
1529
<p class="since">Since 2.30</p>
1530
1530
</div>
1531
1531
</div>