1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>ExampleAnimal</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GIO Reference Manual">
8 <link rel="up" href="ch30s05.html" title="Generating code and docs">
9 <link rel="prev" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Cat.html" title="org.gtk.GDBus.Example.ObjectManager.Cat">
10 <link rel="next" href="ExampleCat.html" title="ExampleCat">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17 <td><a accesskey="p" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Cat.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="ch30s05.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GIO Reference Manual</th>
21 <td><a accesskey="n" href="ExampleCat.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#ExampleAnimal.synopsis" class="shortcut">Top</a>
26 <a href="#ExampleAnimal.description" class="shortcut">Description</a>
28 <a href="#ExampleAnimal.object-hierarchy" class="shortcut">Object Hierarchy</a>
30 <a href="#ExampleAnimal.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
32 <a href="#ExampleAnimal.prerequisites" class="shortcut">Prerequisites</a>
34 <a href="#ExampleAnimal.implementations" class="shortcut">Known Implementations</a>
36 <a href="#ExampleAnimal.properties" class="shortcut">Properties</a>
38 <a href="#ExampleAnimal.signals" class="shortcut">Signals</a>
41 <div class="refentry">
42 <a name="ExampleAnimal"></a><div class="titlepage"></div>
43 <div class="refnamediv"><table width="100%"><tr>
45 <h2><span class="refentrytitle"><a name="ExampleAnimal.top_of_page"></a>ExampleAnimal</span></h2>
46 <p>ExampleAnimal — Generated C code for the org.gtk.GDBus.Example.ObjectManager.Animal D-Bus interface</p>
48 <td valign="top" align="right"></td>
50 <div class="refsynopsisdiv">
51 <a name="ExampleAnimal.synopsis"></a><h2>Synopsis</h2>
52 <a name="ExampleAnimalProxy"></a><a name="ExampleAnimalSkeleton"></a><pre class="synopsis"> <a class="link" href="ExampleAnimal.html#ExampleAnimal-struct" title="ExampleAnimal">ExampleAnimal</a>;
53 struct <a class="link" href="ExampleAnimal.html#ExampleAnimalIface" title="struct ExampleAnimalIface">ExampleAnimalIface</a>;
54 <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="returnvalue">GDBusInterfaceInfo</span></a> * <a class="link" href="ExampleAnimal.html#example-animal-interface-info" title="example_animal_interface_info ()">example_animal_interface_info</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
55 <a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="ExampleAnimal.html#example-animal-override-properties" title="example_animal_override_properties ()">example_animal_override_properties</a> (<em class="parameter"><code><a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *klass</code></em>,
56 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id_begin</code></em>);
57 <span class="returnvalue">void</span> <a class="link" href="ExampleAnimal.html#example-animal-call-poke" title="example_animal_call_poke ()">example_animal_call_poke</a> (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *proxy</code></em>,
58 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_sad</code></em>,
59 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_happy</code></em>,
60 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
61 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
62 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
63 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="ExampleAnimal.html#example-animal-call-poke-finish" title="example_animal_call_poke_finish ()">example_animal_call_poke_finish</a> (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *proxy</code></em>,
64 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
65 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
66 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="ExampleAnimal.html#example-animal-call-poke-sync" title="example_animal_call_poke_sync ()">example_animal_call_poke_sync</a> (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *proxy</code></em>,
67 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_sad</code></em>,
68 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_happy</code></em>,
69 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
70 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
71 <span class="returnvalue">void</span> <a class="link" href="ExampleAnimal.html#example-animal-complete-poke" title="example_animal_complete_poke ()">example_animal_complete_poke</a> (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>,
72 <em class="parameter"><code><a class="link" href="GDBusMethodInvocation.html" title="GDBusMethodInvocation"><span class="type">GDBusMethodInvocation</span></a> *invocation</code></em>);
73 <span class="returnvalue">void</span> <a class="link" href="ExampleAnimal.html#example-animal-emit-jumped" title="example_animal_emit_jumped ()">example_animal_emit_jumped</a> (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>,
74 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> arg_height</code></em>);
75 const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="ExampleAnimal.html#example-animal-get-mood" title="example_animal_get_mood ()">example_animal_get_mood</a> (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>);
76 <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="ExampleAnimal.html#example-animal-dup-mood" title="example_animal_dup_mood ()">example_animal_dup_mood</a> (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>);
77 <span class="returnvalue">void</span> <a class="link" href="ExampleAnimal.html#example-animal-set-mood" title="example_animal_set_mood ()">example_animal_set_mood</a> (<em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object</code></em>,
78 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
79 struct <a class="link" href="ExampleAnimal.html#ExampleAnimalProxy-struct" title="struct ExampleAnimalProxy">ExampleAnimalProxy</a>;
80 struct <a class="link" href="ExampleAnimal.html#ExampleAnimalProxyClass" title="struct ExampleAnimalProxyClass">ExampleAnimalProxyClass</a>;
81 <span class="returnvalue">void</span> <a class="link" href="ExampleAnimal.html#example-animal-proxy-new" title="example_animal_proxy_new ()">example_animal_proxy_new</a> (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
82 <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
83 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
84 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
85 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
86 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
87 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
88 <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> * <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-finish" title="example_animal_proxy_new_finish ()">example_animal_proxy_new_finish</a> (<em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
89 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
90 <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> * <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-sync" title="example_animal_proxy_new_sync ()">example_animal_proxy_new_sync</a> (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
91 <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
92 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
93 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
94 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
95 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
96 <span class="returnvalue">void</span> <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-for-bus" title="example_animal_proxy_new_for_bus ()">example_animal_proxy_new_for_bus</a> (<em class="parameter"><code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
97 <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
98 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
99 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
100 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
101 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
102 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
103 <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> * <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-for-bus-finish" title="example_animal_proxy_new_for_bus_finish ()">example_animal_proxy_new_for_bus_finish</a>
104 (<em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
105 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
106 <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> * <a class="link" href="ExampleAnimal.html#example-animal-proxy-new-for-bus-sync" title="example_animal_proxy_new_for_bus_sync ()">example_animal_proxy_new_for_bus_sync</a>
107 (<em class="parameter"><code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
108 <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
109 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
110 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
111 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
112 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
113 struct <a class="link" href="ExampleAnimal.html#ExampleAnimalSkeleton-struct" title="struct ExampleAnimalSkeleton">ExampleAnimalSkeleton</a>;
114 struct <a class="link" href="ExampleAnimal.html#ExampleAnimalSkeletonClass" title="struct ExampleAnimalSkeletonClass">ExampleAnimalSkeletonClass</a>;
115 <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> * <a class="link" href="ExampleAnimal.html#example-animal-skeleton-new" title="example_animal_skeleton_new ()">example_animal_skeleton_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
118 <div class="refsect1">
119 <a name="ExampleAnimal.object-hierarchy"></a><h2>Object Hierarchy</h2>
120 <pre class="synopsis">
124 <pre class="synopsis">
125 <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
126 +----<a class="link" href="GDBusProxy.html" title="GDBusProxy">GDBusProxy</a>
127 +----ExampleAnimalProxy
129 <pre class="synopsis">
130 <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
131 +----<a class="link" href="GDBusInterfaceSkeleton.html" title="GDBusInterfaceSkeleton">GDBusInterfaceSkeleton</a>
132 +----ExampleAnimalSkeleton
135 <div class="refsect1">
136 <a name="ExampleAnimal.prerequisites"></a><h2>Prerequisites</h2>
138 ExampleAnimal requires
139 <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
141 <div class="refsect1">
142 <a name="ExampleAnimal.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
144 ExampleAnimalProxy implements
145 <a class="link" href="GDBusInterface.html" title="GDBusInterface">GDBusInterface</a>, <a class="link" href="GInitable.html" title="GInitable">GInitable</a>, <a class="link" href="GAsyncInitable.html" title="GAsyncInitable">GAsyncInitable</a> and <a class="link" href="ExampleAnimal.html" title="ExampleAnimal">ExampleAnimal</a>.</p>
147 ExampleAnimalSkeleton implements
148 <a class="link" href="GDBusInterface.html" title="GDBusInterface">GDBusInterface</a> and <a class="link" href="ExampleAnimal.html" title="ExampleAnimal">ExampleAnimal</a>.</p>
150 <div class="refsect1">
151 <a name="ExampleAnimal.implementations"></a><h2>Known Implementations</h2>
153 ExampleAnimal is implemented by
154 <a class="link" href="ExampleAnimal.html#ExampleAnimalProxy">ExampleAnimalProxy</a> and <a class="link" href="ExampleAnimal.html#ExampleAnimalSkeleton">ExampleAnimalSkeleton</a>.</p>
156 <div class="refsect1">
157 <a name="ExampleAnimal.properties"></a><h2>Properties</h2>
158 <pre class="synopsis">
159 "<a class="link" href="ExampleAnimal.html#ExampleAnimal--mood" title='The "mood" property'>mood</a>" <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write
162 <div class="refsect1">
163 <a name="ExampleAnimal.signals"></a><h2>Signals</h2>
164 <pre class="synopsis">
165 "<a class="link" href="ExampleAnimal.html#ExampleAnimal-handle-poke" title='The "handle-poke" signal'>handle-poke</a>" : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
166 "<a class="link" href="ExampleAnimal.html#ExampleAnimal-jumped" title='The "jumped" signal'>jumped</a>" : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
169 <div class="refsect1">
170 <a name="ExampleAnimal.description"></a><h2>Description</h2>
172 This section contains code for working with the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</a> D-Bus interface in C.
175 <div class="refsect1">
176 <a name="ExampleAnimal.details"></a><h2>Details</h2>
177 <div class="refsect2">
178 <a name="ExampleAnimal-struct"></a><h3>ExampleAnimal</h3>
179 <pre class="programlisting">typedef struct _ExampleAnimal ExampleAnimal;</pre>
181 Abstract interface type for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</a>.
183 <p class="since">Since 2.30</p>
186 <div class="refsect2">
187 <a name="ExampleAnimalIface"></a><h3>struct ExampleAnimalIface</h3>
188 <pre class="programlisting">struct ExampleAnimalIface {
189 GTypeInterface parent_iface;
193 gboolean (*handle_poke) (
194 ExampleAnimal *object,
195 GDBusMethodInvocation *invocation,
196 gboolean arg_make_sad,
197 gboolean arg_make_happy);
199 const gchar * (*get_mood) (ExampleAnimal *object);
202 ExampleAnimal *object,
207 Virtual table for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</a>.
209 <div class="variablelist"><table border="0">
210 <col align="left" valign="top">
213 <td><p><span class="term"><a href="./../gobject/gobject/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>;</span></p></td>
214 <td>The parent interface.</td>
217 <td><p><span class="term"><em class="structfield"><code><a name="ExampleAnimalIface.handle-poke"></a>handle_poke</code></em> ()</span></p></td>
218 <td>Handler for the <a class="link" href="ExampleAnimal.html#ExampleAnimal-handle-poke" title='The "handle-poke" signal'><span class="type">"handle-poke"</span></a> signal.</td>
221 <td><p><span class="term"><em class="structfield"><code><a name="ExampleAnimalIface.get-mood"></a>get_mood</code></em> ()</span></p></td>
222 <td>Getter for the <a class="link" href="ExampleAnimal.html#ExampleAnimal--mood" title='The "mood" property'><span class="type">"mood"</span></a> property.</td>
225 <td><p><span class="term"><em class="structfield"><code><a name="ExampleAnimalIface.jumped"></a>jumped</code></em> ()</span></p></td>
226 <td>Handler for the <a class="link" href="ExampleAnimal.html#ExampleAnimal-jumped" title='The "jumped" signal'><span class="type">"jumped"</span></a> signal.</td>
230 <p class="since">Since 2.30</p>
233 <div class="refsect2">
234 <a name="example-animal-interface-info"></a><h3>example_animal_interface_info ()</h3>
235 <pre class="programlisting"><a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="returnvalue">GDBusInterfaceInfo</span></a> * example_animal_interface_info (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
237 Gets a machine-readable description of the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</a> D-Bus interface.
239 <div class="variablelist"><table border="0">
240 <col align="left" valign="top">
242 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
243 <td>A <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a>. Do not free. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
247 <p class="since">Since 2.30</p>
250 <div class="refsect2">
251 <a name="example-animal-override-properties"></a><h3>example_animal_override_properties ()</h3>
252 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> example_animal_override_properties (<em class="parameter"><code><a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *klass</code></em>,
253 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id_begin</code></em>);</pre>
255 Overrides all <a href="./../gobject/gobject/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.
256 The properties are overridden in the order they are defined.
258 <div class="variablelist"><table border="0">
259 <col align="left" valign="top">
262 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
263 <td>The class structure for a <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>-derived class.</td>
266 <td><p><span class="term"><em class="parameter"><code>property_id_begin</code></em> :</span></p></td>
267 <td>The property id to assign to the first overridden property.</td>
270 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
271 <td>The last property id.</td>
275 <p class="since">Since 2.30</p>
278 <div class="refsect2">
279 <a name="example-animal-call-poke"></a><h3>example_animal_call_poke ()</h3>
280 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
281 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_sad</code></em>,
282 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_happy</code></em>,
283 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
284 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
285 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
287 Asynchronously invokes the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke" title="The Poke() method"><code class="function">Poke()</code></a> D-Bus method on <em class="parameter"><code>proxy</code></em>.
288 When the operation is finished, <em class="parameter"><code>callback</code></em> will be invoked in the <a href="./../glib/glib/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.
289 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.
292 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.
294 <div class="variablelist"><table border="0">
295 <col align="left" valign="top">
298 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
299 <td>A <a class="link" href="ExampleAnimal.html#ExampleAnimalProxy"><span class="type">ExampleAnimalProxy</span></a>.</td>
302 <td><p><span class="term"><em class="parameter"><code>arg_make_sad</code></em> :</span></p></td>
303 <td>Argument to pass with the method invocation.</td>
306 <td><p><span class="term"><em class="parameter"><code>arg_make_happy</code></em> :</span></p></td>
307 <td>Argument to pass with the method invocation.</td>
310 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
311 <td>A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
315 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
316 <td>A <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
319 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
320 <td>User data to pass to <em class="parameter"><code>callback</code></em>.</td>
324 <p class="since">Since 2.30</p>
327 <div class="refsect2">
328 <a name="example-animal-call-poke-finish"></a><h3>example_animal_call_poke_finish ()</h3>
329 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 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>,
330 <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
331 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
333 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>.
335 <div class="variablelist"><table border="0">
336 <col align="left" valign="top">
339 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
340 <td>A <a class="link" href="ExampleAnimal.html#ExampleAnimalProxy"><span class="type">ExampleAnimalProxy</span></a>.</td>
343 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
344 <td>The <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> obtained from the <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="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>.</td>
347 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
348 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
351 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
353 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call succeded, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[skip]</span>
358 <p class="since">Since 2.30</p>
361 <div class="refsect2">
362 <a name="example-animal-call-poke-sync"></a><h3>example_animal_call_poke_sync ()</h3>
363 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 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>,
364 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_sad</code></em>,
365 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_happy</code></em>,
366 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
367 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
369 Synchronously invokes the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke" title="The Poke() method"><code class="function">Poke()</code></a> D-Bus method on <em class="parameter"><code>proxy</code></em>. The calling thread is blocked until a reply is received.
372 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.
374 <div class="variablelist"><table border="0">
375 <col align="left" valign="top">
378 <td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
379 <td>A <a class="link" href="ExampleAnimal.html#ExampleAnimalProxy"><span class="type">ExampleAnimalProxy</span></a>.</td>
382 <td><p><span class="term"><em class="parameter"><code>arg_make_sad</code></em> :</span></p></td>
383 <td>Argument to pass with the method invocation.</td>
386 <td><p><span class="term"><em class="parameter"><code>arg_make_happy</code></em> :</span></p></td>
387 <td>Argument to pass with the method invocation.</td>
390 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
391 <td>A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
395 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
396 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
399 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
401 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the call succeded, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[skip]</span>
406 <p class="since">Since 2.30</p>
409 <div class="refsect2">
410 <a name="example-animal-complete-poke"></a><h3>example_animal_complete_poke ()</h3>
411 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
412 <em class="parameter"><code><a class="link" href="GDBusMethodInvocation.html" title="GDBusMethodInvocation"><span class="type">GDBusMethodInvocation</span></a> *invocation</code></em>);</pre>
414 Helper function used in service implementations to finish handling invocations of the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke" title="The Poke() method"><code class="function">Poke()</code></a> D-Bus method. If you instead want to finish handling an invocation by returning an error, use <a class="link" href="GDBusMethodInvocation.html#g-dbus-method-invocation-return-error" title="g_dbus_method_invocation_return_error ()"><code class="function">g_dbus_method_invocation_return_error()</code></a> or similar.
417 This method will free <em class="parameter"><code>invocation</code></em>, you cannot use it afterwards.
419 <div class="variablelist"><table border="0">
420 <col align="left" valign="top">
423 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
424 <td>A <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a>.</td>
427 <td><p><span class="term"><em class="parameter"><code>invocation</code></em> :</span></p></td>
428 <td>A <a class="link" href="GDBusMethodInvocation.html" title="GDBusMethodInvocation"><span class="type">GDBusMethodInvocation</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
433 <p class="since">Since 2.30</p>
436 <div class="refsect2">
437 <a name="example-animal-emit-jumped"></a><h3>example_animal_emit_jumped ()</h3>
438 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
439 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> arg_height</code></em>);</pre>
441 Emits the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-signal-org-gtk-GDBus-Example-ObjectManager-Animal.Jumped" title='The "Jumped" signal'>"Jumped"</a> D-Bus signal.
443 <div class="variablelist"><table border="0">
444 <col align="left" valign="top">
447 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
448 <td>A <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a>.</td>
451 <td><p><span class="term"><em class="parameter"><code>arg_height</code></em> :</span></p></td>
452 <td>Argument to pass with the signal.</td>
456 <p class="since">Since 2.30</p>
459 <div class="refsect2">
460 <a name="example-animal-get-mood"></a><h3>example_animal_get_mood ()</h3>
461 <pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
463 Gets the value of the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood" title='The "Mood" property'>"Mood"</a> D-Bus property.
466 Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
470 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
471 <h3 class="title">Warning</h3>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>
474 <div class="variablelist"><table border="0">
475 <col align="left" valign="top">
478 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
479 <td>A <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a>.</td>
482 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
483 <td>The property value or <a href="./../glib/glib/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>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
488 <p class="since">Since 2.30</p>
491 <div class="refsect2">
492 <a name="example-animal-dup-mood"></a><h3>example_animal_dup_mood ()</h3>
493 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 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>
495 Gets a copy of the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood" title='The "Mood" property'>"Mood"</a> D-Bus property.
498 Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
500 <div class="variablelist"><table border="0">
501 <col align="left" valign="top">
504 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
505 <td>A <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a>.</td>
508 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
509 <td>The property value or <a href="./../glib/glib/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="./../glib/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
514 <p class="since">Since 2.30</p>
517 <div class="refsect2">
518 <a name="example-animal-set-mood"></a><h3>example_animal_set_mood ()</h3>
519 <pre class="programlisting"><span class="returnvalue">void</span> 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>,
520 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
522 Sets the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood" title='The "Mood" property'>"Mood"</a> D-Bus property to <em class="parameter"><code>value</code></em>.
525 Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
527 <div class="variablelist"><table border="0">
528 <col align="left" valign="top">
531 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
532 <td>A <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a>.</td>
535 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
536 <td>The value to set.</td>
540 <p class="since">Since 2.30</p>
543 <div class="refsect2">
544 <a name="ExampleAnimalProxy-struct"></a><h3>struct ExampleAnimalProxy</h3>
545 <pre class="programlisting">struct ExampleAnimalProxy;</pre>
547 The <a class="link" href="ExampleAnimal.html#ExampleAnimalProxy"><span class="type">ExampleAnimalProxy</span></a> structure contains only private data and should only be accessed using the provided API.
549 <p class="since">Since 2.30</p>
552 <div class="refsect2">
553 <a name="ExampleAnimalProxyClass"></a><h3>struct ExampleAnimalProxyClass</h3>
554 <pre class="programlisting">struct ExampleAnimalProxyClass {
555 GDBusProxyClass parent_class;
559 Class structure for <a class="link" href="ExampleAnimal.html#ExampleAnimalProxy"><span class="type">ExampleAnimalProxy</span></a>.
561 <div class="variablelist"><table border="0">
562 <col align="left" valign="top">
564 <td><p><span class="term"><a class="link" href="GDBusProxy.html#GDBusProxyClass" title="struct GDBusProxyClass"><span class="type">GDBusProxyClass</span></a> <em class="structfield"><code><a name="ExampleAnimalProxyClass.parent-class"></a>parent_class</code></em>;</span></p></td>
565 <td>The parent class.</td>
568 <p class="since">Since 2.30</p>
571 <div class="refsect2">
572 <a name="example-animal-proxy-new"></a><h3>example_animal_proxy_new ()</h3>
573 <pre class="programlisting"><span class="returnvalue">void</span> example_animal_proxy_new (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
574 <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
575 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
576 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
577 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
578 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
579 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
581 Asynchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</a>. See <a class="link" href="GDBusProxy.html#g-dbus-proxy-new" title="g_dbus_proxy_new ()"><code class="function">g_dbus_proxy_new()</code></a> for more details.
584 When the operation is finished, <em class="parameter"><code>callback</code></em> will be invoked in the <a href="./../glib/glib/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.
585 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.
588 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.
590 <div class="variablelist"><table border="0">
591 <col align="left" valign="top">
594 <td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
595 <td>A <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>.</td>
598 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
599 <td>Flags from the <a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
602 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
603 <td>A bus name (well-known or unique) or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em> is not a message bus connection. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
607 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
608 <td>An object path.</td>
611 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
612 <td>A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
616 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
617 <td>A <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</td>
620 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
621 <td>User data to pass to <em class="parameter"><code>callback</code></em>.</td>
625 <p class="since">Since 2.30</p>
628 <div class="refsect2">
629 <a name="example-animal-proxy-new-finish"></a><h3>example_animal_proxy_new_finish ()</h3>
630 <pre class="programlisting"><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> * example_animal_proxy_new_finish (<em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
631 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
633 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>.
635 <div class="variablelist"><table border="0">
636 <col align="left" valign="top">
639 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
640 <td>The <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> obtained from the <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="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>.</td>
643 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
644 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
648 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
649 <td>The constructed proxy object or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> ExampleAnimalProxy]</span>
654 <p class="since">Since 2.30</p>
657 <div class="refsect2">
658 <a name="example-animal-proxy-new-sync"></a><h3>example_animal_proxy_new_sync ()</h3>
659 <pre class="programlisting"><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> * example_animal_proxy_new_sync (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
660 <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
661 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
662 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
663 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
664 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
666 Synchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</a>. See <a class="link" href="GDBusProxy.html#g-dbus-proxy-new-sync" title="g_dbus_proxy_new_sync ()"><code class="function">g_dbus_proxy_new_sync()</code></a> for more details.
669 The calling thread is blocked until a reply is received.
672 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.
674 <div class="variablelist"><table border="0">
675 <col align="left" valign="top">
678 <td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
679 <td>A <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>.</td>
682 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
683 <td>Flags from the <a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
686 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
687 <td>A bus name (well-known or unique) or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em> is not a message bus connection. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
691 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
692 <td>An object path.</td>
695 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
696 <td>A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
700 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
701 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
705 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
706 <td>The constructed proxy object or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> ExampleAnimalProxy]</span>
711 <p class="since">Since 2.30</p>
714 <div class="refsect2">
715 <a name="example-animal-proxy-new-for-bus"></a><h3>example_animal_proxy_new_for_bus ()</h3>
716 <pre class="programlisting"><span class="returnvalue">void</span> example_animal_proxy_new_for_bus (<em class="parameter"><code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
717 <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
718 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
719 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
720 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
721 <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
722 <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
724 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 class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> instead of a <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>.
727 When the operation is finished, <em class="parameter"><code>callback</code></em> will be invoked in the <a href="./../glib/glib/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.
728 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.
731 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.
733 <div class="variablelist"><table border="0">
734 <col align="left" valign="top">
737 <td><p><span class="term"><em class="parameter"><code>bus_type</code></em> :</span></p></td>
738 <td>A <a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a>.</td>
741 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
742 <td>Flags from the <a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
745 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
746 <td>A bus name (well-known or unique).</td>
749 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
750 <td>An object path.</td>
753 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
754 <td>A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
758 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
759 <td>A <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</td>
762 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
763 <td>User data to pass to <em class="parameter"><code>callback</code></em>.</td>
767 <p class="since">Since 2.30</p>
770 <div class="refsect2">
771 <a name="example-animal-proxy-new-for-bus-finish"></a><h3>example_animal_proxy_new_for_bus_finish ()</h3>
772 <pre class="programlisting"><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> * example_animal_proxy_new_for_bus_finish
773 (<em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
774 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
776 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>.
778 <div class="variablelist"><table border="0">
779 <col align="left" valign="top">
782 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
783 <td>The <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> obtained from the <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="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>.</td>
786 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
787 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
791 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
792 <td>The constructed proxy object or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> ExampleAnimalProxy]</span>
797 <p class="since">Since 2.30</p>
800 <div class="refsect2">
801 <a name="example-animal-proxy-new-for-bus-sync"></a><h3>example_animal_proxy_new_for_bus_sync ()</h3>
802 <pre class="programlisting"><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> * example_animal_proxy_new_for_bus_sync
803 (<em class="parameter"><code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
804 <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
805 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
806 <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
807 <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
808 <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
810 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 class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> instead of a <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>.
813 The calling thread is blocked until a reply is received.
816 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.
818 <div class="variablelist"><table border="0">
819 <col align="left" valign="top">
822 <td><p><span class="term"><em class="parameter"><code>bus_type</code></em> :</span></p></td>
823 <td>A <a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a>.</td>
826 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
827 <td>Flags from the <a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
830 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
831 <td>A bus name (well-known or unique).</td>
834 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
835 <td>An object path.</td>
838 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
839 <td>A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
843 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
844 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
848 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
849 <td>The constructed proxy object or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> ExampleAnimalProxy]</span>
854 <p class="since">Since 2.30</p>
857 <div class="refsect2">
858 <a name="ExampleAnimalSkeleton-struct"></a><h3>struct ExampleAnimalSkeleton</h3>
859 <pre class="programlisting">struct ExampleAnimalSkeleton;</pre>
861 The <a class="link" href="ExampleAnimal.html#ExampleAnimalSkeleton"><span class="type">ExampleAnimalSkeleton</span></a> structure contains only private data and should only be accessed using the provided API.
863 <p class="since">Since 2.30</p>
866 <div class="refsect2">
867 <a name="ExampleAnimalSkeletonClass"></a><h3>struct ExampleAnimalSkeletonClass</h3>
868 <pre class="programlisting">struct ExampleAnimalSkeletonClass {
869 GDBusInterfaceSkeletonClass parent_class;
873 Class structure for <a class="link" href="ExampleAnimal.html#ExampleAnimalSkeleton"><span class="type">ExampleAnimalSkeleton</span></a>.
875 <div class="variablelist"><table border="0">
876 <col align="left" valign="top">
878 <td><p><span class="term"><a class="link" href="GDBusInterfaceSkeleton.html#GDBusInterfaceSkeletonClass" title="struct GDBusInterfaceSkeletonClass"><span class="type">GDBusInterfaceSkeletonClass</span></a> <em class="structfield"><code><a name="ExampleAnimalSkeletonClass.parent-class"></a>parent_class</code></em>;</span></p></td>
879 <td>The parent class.</td>
882 <p class="since">Since 2.30</p>
885 <div class="refsect2">
886 <a name="example-animal-skeleton-new"></a><h3>example_animal_skeleton_new ()</h3>
887 <pre class="programlisting"><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> * example_animal_skeleton_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
889 Creates a skeleton object for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Animal.top_of_page">org.gtk.GDBus.Example.ObjectManager.Animal</a>.
891 <div class="variablelist"><table border="0">
892 <col align="left" valign="top">
894 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
895 <td>The skeleton object. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> ExampleAnimalSkeleton]</span>
899 <p class="since">Since 2.30</p>
902 <div class="refsect1">
903 <a name="ExampleAnimal.property-details"></a><h2>Property Details</h2>
904 <div class="refsect2">
905 <a name="ExampleAnimal--mood"></a><h3>The <code class="literal">"mood"</code> property</h3>
906 <pre class="programlisting"> "mood" <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre>
908 Represents the D-Bus property <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-property-org-gtk-GDBus-Example-ObjectManager-Animal.Mood" title='The "Mood" property'>"Mood"</a>.
911 Since the D-Bus property for this <a href="./../gobject/gobject/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.
913 <p>Default value: NULL</p>
914 <p class="since">Since 2.30</p>
917 <div class="refsect1">
918 <a name="ExampleAnimal.signal-details"></a><h2>Signal Details</h2>
919 <div class="refsect2">
920 <a name="ExampleAnimal-handle-poke"></a><h3>The <code class="literal">"handle-poke"</code> signal</h3>
921 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> user_function (<a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object,
922 <a class="link" href="GDBusMethodInvocation.html" title="GDBusMethodInvocation"><span class="type">GDBusMethodInvocation</span></a> *invocation,
923 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_sad,
924 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_happy,
925 <a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
927 Signal emitted when a remote caller is invoking the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-method-org-gtk-GDBus-Example-ObjectManager-Animal.Poke" title="The Poke() method"><code class="function">Poke()</code></a> D-Bus method.
930 If a signal handler returns <a href="./../glib/glib/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> 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 class="link" href="GDBusMethodInvocation.html#g-dbus-method-invocation-return-error" title="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 class="link" href="gio-GDBusError.html#G-DBUS-ERROR-UNKNOWN-METHOD:CAPS"><code class="literal">G_DBUS_ERROR_UNKNOWN_METHOD</code></a> error is returned.
932 <div class="variablelist"><table border="0">
933 <col align="left" valign="top">
936 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
937 <td>A <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a>.</td>
940 <td><p><span class="term"><em class="parameter"><code>invocation</code></em> :</span></p></td>
941 <td>A <a class="link" href="GDBusMethodInvocation.html" title="GDBusMethodInvocation"><span class="type">GDBusMethodInvocation</span></a>.</td>
944 <td><p><span class="term"><em class="parameter"><code>arg_make_sad</code></em> :</span></p></td>
945 <td>Argument passed by remote caller.</td>
948 <td><p><span class="term"><em class="parameter"><code>arg_make_happy</code></em> :</span></p></td>
949 <td>Argument passed by remote caller.</td>
952 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
953 <td>user data set when the signal handler was connected.</td>
956 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
958 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the invocation was handled, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to let other signal handlers run.</td>
962 <p class="since">Since 2.30</p>
965 <div class="refsect2">
966 <a name="ExampleAnimal-jumped"></a><h3>The <code class="literal">"jumped"</code> signal</h3>
967 <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *object,
968 <a href="./../glib/glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> arg_height,
969 <a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
971 On the client-side, this signal is emitted whenever the D-Bus signal <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Animal.html#gdbus-signal-org-gtk-GDBus-Example-ObjectManager-Animal.Jumped" title='The "Jumped" signal'>"Jumped"</a> is received.
974 On the service-side, this signal can be used with e.g. <a href="./../gobject/gobject/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.
976 <div class="variablelist"><table border="0">
977 <col align="left" valign="top">
980 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
981 <td>A <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a>.</td>
984 <td><p><span class="term"><em class="parameter"><code>arg_height</code></em> :</span></p></td>
988 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
989 <td>user data set when the signal handler was connected.</td>
993 <p class="since">Since 2.30</p>
999 Generated by GTK-Doc V1.18</div>