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

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   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="">
   8 <link rel="up" href="ch01.html" title="bar">
   9 <link rel="prev" href="ch01.html" title="bar">
  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">
  13 </head>
  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">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="ch01.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="ch01.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"></th>
  21 <td><a accesskey="n" href="ExampleCat.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#ExampleAnimal.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#ExampleAnimal.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#ExampleAnimal.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#ExampleAnimal.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
  31                    |
  32                   <a href="#ExampleAnimal.prerequisites" class="shortcut">Prerequisites</a>
  33                    |
  34                   <a href="#ExampleAnimal.implementations" class="shortcut">Known Implementations</a>
  35                    |
  36                   <a href="#ExampleAnimal.properties" class="shortcut">Properties</a>
  37                    |
  38                   <a href="#ExampleAnimal.signals" class="shortcut">Signals</a>
  39 </td></tr>
  40 </table>
  41 <div class="refentry">
  42 <a name="ExampleAnimal"></a><div class="titlepage"></div>
  43 <div class="refnamediv"><table width="100%"><tr>
  44 <td valign="top">
  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>
  47 </td>
  48 <td valign="top" align="right"></td>
  49 </tr></table></div>
  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 href="http://library.gnome.org/devel/gio/unstable/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="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *klass</code></em>,
  56                                                          <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>);
  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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_sad</code></em>,
  59                                                          <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>,
  60                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
  61                                                          <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>,
  62                                                          <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>);
  63 <a href="http://library.gnome.org/devel/glib/unstable/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 href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
  65                                                          <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>);
  66 <a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_sad</code></em>,
  68                                                          <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>,
  69                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
  70                                                          <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>);
  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 href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html"><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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> arg_height</code></em>);
  75 const <a href="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/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 href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
  82                                                          <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>,
  83                                                          <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>,
  84                                                          <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>,
  85                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
  86                                                          <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>,
  87                                                          <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>);
  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 href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
  89                                                          <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>);
  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 href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
  91                                                          <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>,
  92                                                          <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>,
  93                                                          <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>,
  94                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
  95                                                          <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>);
  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 href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
  97                                                          <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>,
  98                                                          <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>,
  99                                                          <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>,
 100                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 101                                                          <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>,
 102                                                          <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>);
 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 href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
 105                                                          <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>);
 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 href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
 108                                                          <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>,
 109                                                          <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>,
 110                                                          <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>,
 111                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 112                                                          <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>);
 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>);
 116 </pre>
 117 </div>
 118 <div class="refsect1">
 119 <a name="ExampleAnimal.object-hierarchy"></a><h2>Object Hierarchy</h2>
 120 <pre class="synopsis">
 121   GInterface
 122    +----ExampleAnimal
 123 </pre>
 124 <pre class="synopsis">
 125   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 126    +----<a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html">GDBusProxy</a>
 127          +----ExampleAnimalProxy
 128 </pre>
 129 <pre class="synopsis">
 130   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 131    +----<a href="http://library.gnome.org/devel/gio/unstable/GDBusInterfaceSkeleton.html">GDBusInterfaceSkeleton</a>
 132          +----ExampleAnimalSkeleton
 133 </pre>
 134 </div>
 135 <div class="refsect1">
 136 <a name="ExampleAnimal.prerequisites"></a><h2>Prerequisites</h2>
 137 <p>
 138 ExampleAnimal requires
 139  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
 140 </div>
 141 <div class="refsect1">
 142 <a name="ExampleAnimal.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
 143 <p>
 144 ExampleAnimalProxy implements
 145  <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>
 146 <p>
 147 ExampleAnimalSkeleton implements
 148  <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>
 149 </div>
 150 <div class="refsect1">
 151 <a name="ExampleAnimal.implementations"></a><h2>Known Implementations</h2>
 152 <p>
 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>
 155 </div>
 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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 160 </pre>
 161 </div>
 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="http://library.gnome.org/devel/gobject/unstable/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="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 167 </pre>
 168 </div>
 169 <div class="refsect1">
 170 <a name="ExampleAnimal.description"></a><h2>Description</h2>
 171 <p>
 172 This section contains code for working with the org.gtk.GDBus.Example.ObjectManager.Animal D-Bus interface in C.
 173 </p>
 174 </div>
 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>
 180 <p>
 181 Abstract interface type for the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Animal.
 182 </p>
 183 <p class="since">Since 2.30</p>
 184 </div>
 185 <hr>
 186 <div class="refsect2">
 187 <a name="ExampleAnimalIface"></a><h3>struct ExampleAnimalIface</h3>
 188 <pre class="programlisting">struct ExampleAnimalIface {
 189   GTypeInterface parent_iface;
 190
 191
 192
 193   gboolean (*handle_poke) (
 194     ExampleAnimal *object,
 195     GDBusMethodInvocation *invocation,
 196     gboolean arg_make_sad,
 197     gboolean arg_make_happy);
 198
 199   const gchar * (*get_mood) (ExampleAnimal *object);
 200
 201   void (*jumped) (
 202     ExampleAnimal *object,
 203     gdouble arg_height);
 204 };
 205 </pre>
 206 <p>
 207 Virtual table for the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Animal.
 208 </p>
 209 <div class="variablelist"><table border="0">
 210 <col align="left" valign="top">
 211 <tbody>
 212 <tr>
 213 <td><p><span class="term"><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>;</span></p></td>
 214 <td>The parent interface.</td>
 215 </tr>
 216 <tr>
 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>
 219 </tr>
 220 <tr>
 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>
 223 </tr>
 224 <tr>
 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>
 227 </tr>
 228 </tbody>
 229 </table></div>
 230 <p class="since">Since 2.30</p>
 231 </div>
 232 <hr>
 233 <div class="refsect2">
 234 <a name="example-animal-interface-info"></a><h3>example_animal_interface_info ()</h3>
 235 <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> * example_animal_interface_info      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 236 <p>
 237 Gets a machine-readable description of the org.gtk.GDBus.Example.ObjectManager.Animal D-Bus interface.
 238 </p>
 239 <div class="variablelist"><table border="0">
 240 <col align="left" valign="top">
 241 <tbody><tr>
 242 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 243 <td>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. <span class="annotation">[<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span>
 244 </td>
 245 </tr></tbody>
 246 </table></div>
 247 <p class="since">Since 2.30</p>
 248 </div>
 249 <hr>
 250 <div class="refsect2">
 251 <a name="example-animal-override-properties"></a><h3>example_animal_override_properties ()</h3>
 252 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               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>,
 253                                                          <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>
 254 <p>
 255 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.
 256 The properties are overridden in the order they are defined.
 257 </p>
 258 <div class="variablelist"><table border="0">
 259 <col align="left" valign="top">
 260 <tbody>
 261 <tr>
 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="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>-derived class.</td>
 264 </tr>
 265 <tr>
 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>
 268 </tr>
 269 <tr>
 270 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 271 <td>The last property id.</td>
 272 </tr>
 273 </tbody>
 274 </table></div>
 275 <p class="since">Since 2.30</p>
 276 </div>
 277 <hr>
 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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_sad</code></em>,
 282                                                          <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>,
 283                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 284                                                          <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>,
 285                                                          <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>
 286 <p>
 287 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>.
 288 When the operation is finished, <em class="parameter"><code>callback</code></em> 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.
 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.
 290 </p>
 291 <p>
 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.
 293 </p>
 294 <div class="variablelist"><table border="0">
 295 <col align="left" valign="top">
 296 <tbody>
 297 <tr>
 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>
 300 </tr>
 301 <tr>
 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>
 304 </tr>
 305 <tr>
 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>
 308 </tr>
 309 <tr>
 310 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
 311 <td>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>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
 312 </td>
 313 </tr>
 314 <tr>
 315 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 316 <td>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>.</td>
 317 </tr>
 318 <tr>
 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>
 321 </tr>
 322 </tbody>
 323 </table></div>
 324 <p class="since">Since 2.30</p>
 325 </div>
 326 <hr>
 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="http://library.gnome.org/devel/glib/unstable/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 href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
 331                                                          <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>
 332 <p>
 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>.
 334 </p>
 335 <div class="variablelist"><table border="0">
 336 <col align="left" valign="top">
 337 <tbody>
 338 <tr>
 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>
 341 </tr>
 342 <tr>
 343 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
 344 <td>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>.</td>
 345 </tr>
 346 <tr>
 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="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
 349 </tr>
 350 <tr>
 351 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 352 <td>
 353 <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> is set. <span class="annotation">[skip]</span>
 354 </td>
 355 </tr>
 356 </tbody>
 357 </table></div>
 358 <p class="since">Since 2.30</p>
 359 </div>
 360 <hr>
 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="http://library.gnome.org/devel/glib/unstable/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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_make_sad</code></em>,
 365                                                          <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>,
 366                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 367                                                          <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>
 368 <p>
 369 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>. The calling thread is blocked until a reply is received.
 370 </p>
 371 <p>
 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.
 373 </p>
 374 <div class="variablelist"><table border="0">
 375 <col align="left" valign="top">
 376 <tbody>
 377 <tr>
 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>
 380 </tr>
 381 <tr>
 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>
 384 </tr>
 385 <tr>
 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>
 388 </tr>
 389 <tr>
 390 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
 391 <td>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>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
 392 </td>
 393 </tr>
 394 <tr>
 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="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
 397 </tr>
 398 <tr>
 399 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 400 <td>
 401 <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> is set. <span class="annotation">[skip]</span>
 402 </td>
 403 </tr>
 404 </tbody>
 405 </table></div>
 406 <p class="since">Since 2.30</p>
 407 </div>
 408 <hr>
 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 href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html"><span class="type">GDBusMethodInvocation</span></a> *invocation</code></em>);</pre>
 413 <p>
 414 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.
 415 </p>
 416 <p>
 417 This method will free <em class="parameter"><code>invocation</code></em>, you cannot use it afterwards.
 418 </p>
 419 <div class="variablelist"><table border="0">
 420 <col align="left" valign="top">
 421 <tbody>
 422 <tr>
 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>
 425 </tr>
 426 <tr>
 427 <td><p><span class="term"><em class="parameter"><code>invocation</code></em> :</span></p></td>
 428 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html"><span class="type">GDBusMethodInvocation</span></a>. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
 429 </td>
 430 </tr>
 431 </tbody>
 432 </table></div>
 433 <p class="since">Since 2.30</p>
 434 </div>
 435 <hr>
 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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> arg_height</code></em>);</pre>
 440 <p>
 441 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.
 442 </p>
 443 <div class="variablelist"><table border="0">
 444 <col align="left" valign="top">
 445 <tbody>
 446 <tr>
 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>
 449 </tr>
 450 <tr>
 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>
 453 </tr>
 454 </tbody>
 455 </table></div>
 456 <p class="since">Since 2.30</p>
 457 </div>
 458 <hr>
 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="http://library.gnome.org/devel/glib/unstable/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>
 462 <p>
 463 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.
 464 </p>
 465 <p>
 466 Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
 467 </p>
 468 <p>
 469 </p>
 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>
 472 <p>
 473 </p>
 474 <div class="variablelist"><table border="0">
 475 <col align="left" valign="top">
 476 <tbody>
 477 <tr>
 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>
 480 </tr>
 481 <tr>
 482 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 483 <td>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>. <span class="annotation">[<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span>
 484 </td>
 485 </tr>
 486 </tbody>
 487 </table></div>
 488 <p class="since">Since 2.30</p>
 489 </div>
 490 <hr>
 491 <div class="refsect2">
 492 <a name="example-animal-dup-mood"></a><h3>example_animal_dup_mood ()</h3>
 493 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/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>
 494 <p>
 495 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.
 496 </p>
 497 <p>
 498 Since this D-Bus property is readable, it is meaningful to use this function on both the client- and service-side.
 499 </p>
 500 <div class="variablelist"><table border="0">
 501 <col align="left" valign="top">
 502 <tbody>
 503 <tr>
 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>
 506 </tr>
 507 <tr>
 508 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 509 <td>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>. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
 510 </td>
 511 </tr>
 512 </tbody>
 513 </table></div>
 514 <p class="since">Since 2.30</p>
 515 </div>
 516 <hr>
 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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
 521 <p>
 522 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>.
 523 </p>
 524 <p>
 525 Since this D-Bus property is not writable, it is only meaningful to use this function on the service-side.
 526 </p>
 527 <div class="variablelist"><table border="0">
 528 <col align="left" valign="top">
 529 <tbody>
 530 <tr>
 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>
 533 </tr>
 534 <tr>
 535 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 536 <td>The value to set.</td>
 537 </tr>
 538 </tbody>
 539 </table></div>
 540 <p class="since">Since 2.30</p>
 541 </div>
 542 <hr>
 543 <div class="refsect2">
 544 <a name="ExampleAnimalProxy-struct"></a><h3>struct ExampleAnimalProxy</h3>
 545 <pre class="programlisting">struct ExampleAnimalProxy;</pre>
 546 <p>
 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.
 548 </p>
 549 <p class="since">Since 2.30</p>
 550 </div>
 551 <hr>
 552 <div class="refsect2">
 553 <a name="ExampleAnimalProxyClass"></a><h3>struct ExampleAnimalProxyClass</h3>
 554 <pre class="programlisting">struct ExampleAnimalProxyClass {
 555   GDBusProxyClass parent_class;
 556 };
 557 </pre>
 558 <p>
 559 Class structure for <a class="link" href="ExampleAnimal.html#ExampleAnimalProxy"><span class="type">ExampleAnimalProxy</span></a>.
 560 </p>
 561 <div class="variablelist"><table border="0">
 562 <col align="left" valign="top">
 563 <tbody><tr>
 564 <td><p><span class="term"><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>;</span></p></td>
 565 <td>The parent class.</td>
 566 </tr></tbody>
 567 </table></div>
 568 <p class="since">Since 2.30</p>
 569 </div>
 570 <hr>
 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 href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
 574                                                          <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>,
 575                                                          <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>,
 576                                                          <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>,
 577                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 578                                                          <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>,
 579                                                          <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>
 580 <p>
 581 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.
 582 </p>
 583 <p>
 584 When the operation is finished, <em class="parameter"><code>callback</code></em> 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.
 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.
 586 </p>
 587 <p>
 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.
 589 </p>
 590 <div class="variablelist"><table border="0">
 591 <col align="left" valign="top">
 592 <tbody>
 593 <tr>
 594 <td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
 595 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</td>
 596 </tr>
 597 <tr>
 598 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 599 <td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
 600 </tr>
 601 <tr>
 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="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> is not a message bus connection. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
 604 </td>
 605 </tr>
 606 <tr>
 607 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
 608 <td>An object path.</td>
 609 </tr>
 610 <tr>
 611 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
 612 <td>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>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
 613 </td>
 614 </tr>
 615 <tr>
 616 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 617 <td>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.</td>
 618 </tr>
 619 <tr>
 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>
 622 </tr>
 623 </tbody>
 624 </table></div>
 625 <p class="since">Since 2.30</p>
 626 </div>
 627 <hr>
 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 href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
 631                                                          <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>
 632 <p>
 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>.
 634 </p>
 635 <div class="variablelist"><table border="0">
 636 <col align="left" valign="top">
 637 <tbody>
 638 <tr>
 639 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
 640 <td>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>.</td>
 641 </tr>
 642 <tr>
 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="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 645 </td>
 646 </tr>
 647 <tr>
 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="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> is set. <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>
 650 </td>
 651 </tr>
 652 </tbody>
 653 </table></div>
 654 <p class="since">Since 2.30</p>
 655 </div>
 656 <hr>
 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 href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a> *connection</code></em>,
 660                                                          <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>,
 661                                                          <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>,
 662                                                          <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>,
 663                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 664                                                          <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>
 665 <p>
 666 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.
 667 </p>
 668 <p>
 669 The calling thread is blocked until a reply is received.
 670 </p>
 671 <p>
 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.
 673 </p>
 674 <div class="variablelist"><table border="0">
 675 <col align="left" valign="top">
 676 <tbody>
 677 <tr>
 678 <td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
 679 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</td>
 680 </tr>
 681 <tr>
 682 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 683 <td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
 684 </tr>
 685 <tr>
 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="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> is not a message bus connection. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
 688 </td>
 689 </tr>
 690 <tr>
 691 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
 692 <td>An object path.</td>
 693 </tr>
 694 <tr>
 695 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
 696 <td>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>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
 697 </td>
 698 </tr>
 699 <tr>
 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="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 702 </td>
 703 </tr>
 704 <tr>
 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="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> is set. <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>
 707 </td>
 708 </tr>
 709 </tbody>
 710 </table></div>
 711 <p class="since">Since 2.30</p>
 712 </div>
 713 <hr>
 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 href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
 717                                                          <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>,
 718                                                          <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>,
 719                                                          <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>,
 720                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 721                                                          <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>,
 722                                                          <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>
 723 <p>
 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 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>.
 725 </p>
 726 <p>
 727 When the operation is finished, <em class="parameter"><code>callback</code></em> 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.
 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.
 729 </p>
 730 <p>
 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.
 732 </p>
 733 <div class="variablelist"><table border="0">
 734 <col align="left" valign="top">
 735 <tbody>
 736 <tr>
 737 <td><p><span class="term"><em class="parameter"><code>bus_type</code></em> :</span></p></td>
 738 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a>.</td>
 739 </tr>
 740 <tr>
 741 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 742 <td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
 743 </tr>
 744 <tr>
 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>
 747 </tr>
 748 <tr>
 749 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
 750 <td>An object path.</td>
 751 </tr>
 752 <tr>
 753 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
 754 <td>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>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
 755 </td>
 756 </tr>
 757 <tr>
 758 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 759 <td>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.</td>
 760 </tr>
 761 <tr>
 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>
 764 </tr>
 765 </tbody>
 766 </table></div>
 767 <p class="since">Since 2.30</p>
 768 </div>
 769 <hr>
 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 href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *res</code></em>,
 774                                                          <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>
 775 <p>
 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>.
 777 </p>
 778 <div class="variablelist"><table border="0">
 779 <col align="left" valign="top">
 780 <tbody>
 781 <tr>
 782 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
 783 <td>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>.</td>
 784 </tr>
 785 <tr>
 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="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 788 </td>
 789 </tr>
 790 <tr>
 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="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> is set. <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>
 793 </td>
 794 </tr>
 795 </tbody>
 796 </table></div>
 797 <p class="since">Since 2.30</p>
 798 </div>
 799 <hr>
 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 href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
 804                                                          <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>,
 805                                                          <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>,
 806                                                          <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>,
 807                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 808                                                          <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>
 809 <p>
 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 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>.
 811 </p>
 812 <p>
 813 The calling thread is blocked until a reply is received.
 814 </p>
 815 <p>
 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.
 817 </p>
 818 <div class="variablelist"><table border="0">
 819 <col align="left" valign="top">
 820 <tbody>
 821 <tr>
 822 <td><p><span class="term"><em class="parameter"><code>bus_type</code></em> :</span></p></td>
 823 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html#GBusType"><span class="type">GBusType</span></a>.</td>
 824 </tr>
 825 <tr>
 826 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 827 <td>Flags from the <a href="http://library.gnome.org/devel/gio/unstable/GDBusProxy.html#GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
 828 </tr>
 829 <tr>
 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>
 832 </tr>
 833 <tr>
 834 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
 835 <td>An object path.</td>
 836 </tr>
 837 <tr>
 838 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
 839 <td>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>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
 840 </td>
 841 </tr>
 842 <tr>
 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="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 845 </td>
 846 </tr>
 847 <tr>
 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="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> is set. <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>
 850 </td>
 851 </tr>
 852 </tbody>
 853 </table></div>
 854 <p class="since">Since 2.30</p>
 855 </div>
 856 <hr>
 857 <div class="refsect2">
 858 <a name="ExampleAnimalSkeleton-struct"></a><h3>struct ExampleAnimalSkeleton</h3>
 859 <pre class="programlisting">struct ExampleAnimalSkeleton;</pre>
 860 <p>
 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.
 862 </p>
 863 <p class="since">Since 2.30</p>
 864 </div>
 865 <hr>
 866 <div class="refsect2">
 867 <a name="ExampleAnimalSkeletonClass"></a><h3>struct ExampleAnimalSkeletonClass</h3>
 868 <pre class="programlisting">struct ExampleAnimalSkeletonClass {
 869   GDBusInterfaceSkeletonClass parent_class;
 870 };
 871 </pre>
 872 <p>
 873 Class structure for <a class="link" href="ExampleAnimal.html#ExampleAnimalSkeleton"><span class="type">ExampleAnimalSkeleton</span></a>.
 874 </p>
 875 <div class="variablelist"><table border="0">
 876 <col align="left" valign="top">
 877 <tbody><tr>
 878 <td><p><span class="term"><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>;</span></p></td>
 879 <td>The parent class.</td>
 880 </tr></tbody>
 881 </table></div>
 882 <p class="since">Since 2.30</p>
 883 </div>
 884 <hr>
 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>
 888 <p>
 889 Creates a skeleton object for the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Animal.
 890 </p>
 891 <div class="variablelist"><table border="0">
 892 <col align="left" valign="top">
 893 <tbody><tr>
 894 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 895 <td>The skeleton object. <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> ExampleAnimalSkeleton]</span>
 896 </td>
 897 </tr></tbody>
 898 </table></div>
 899 <p class="since">Since 2.30</p>
 900 </div>
 901 </div>
 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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 907 <p>
 908 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>.
 909 </p>
 910 <p>
 911 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.
 912 </p>
 913 <p>Default value: NULL</p>
 914 <p class="since">Since 2.30</p>
 915 </div>
 916 </div>
 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="http://library.gnome.org/devel/glib/unstable/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 href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html"><span class="type">GDBusMethodInvocation</span></a> *invocation,
 923                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>               arg_make_sad,
 924                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>               arg_make_happy,
 925                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>               user_data)           : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 926 <p>
 927 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.
 928 </p>
 929 <p>
 930 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> 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.
 931 </p>
 932 <div class="variablelist"><table border="0">
 933 <col align="left" valign="top">
 934 <tbody>
 935 <tr>
 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>
 938 </tr>
 939 <tr>
 940 <td><p><span class="term"><em class="parameter"><code>invocation</code></em> :</span></p></td>
 941 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusMethodInvocation.html"><span class="type">GDBusMethodInvocation</span></a>.</td>
 942 </tr>
 943 <tr>
 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>
 946 </tr>
 947 <tr>
 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>
 950 </tr>
 951 <tr>
 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>
 954 </tr>
 955 <tr>
 956 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 957 <td>
 958 <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.</td>
 959 </tr>
 960 </tbody>
 961 </table></div>
 962 <p class="since">Since 2.30</p>
 963 </div>
 964 <hr>
 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="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a>        arg_height,
 969                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)       : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 970 <p>
 971 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.
 972 </p>
 973 <p>
 974 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.
 975 </p>
 976 <div class="variablelist"><table border="0">
 977 <col align="left" valign="top">
 978 <tbody>
 979 <tr>
 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>
 982 </tr>
 983 <tr>
 984 <td><p><span class="term"><em class="parameter"><code>arg_height</code></em> :</span></p></td>
 985 <td>Argument.</td>
 986 </tr>
 987 <tr>
 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>
 990 </tr>
 991 </tbody>
 992 </table></div>
 993 <p class="since">Since 2.30</p>
 994 </div>
 995 </div>
 996 </div>
 997 <div class="footer">
 998 <hr>
 999           Generated by GTK-Doc V1.18</div>
1000 </body>
1001 </html>