Tizen 2.1 base
[platform/upstream/glib2.0.git] / docs / reference / gio / gdbus-object-manager-example / html / ExampleObject.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>ExampleObject</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="ExampleCat.html" title="ExampleCat">
10 <link rel="next" href="ExampleObjectManagerClient.html" title="ExampleObjectManagerClient">
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="ExampleCat.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="ExampleObjectManagerClient.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="#ExampleObject.synopsis" class="shortcut">Top</a>
25                    | 
26                   <a href="#ExampleObject.description" class="shortcut">Description</a>
27                    | 
28                   <a href="#ExampleObject.object-hierarchy" class="shortcut">Object Hierarchy</a>
29                    | 
30                   <a href="#ExampleObject.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
31                    | 
32                   <a href="#ExampleObject.prerequisites" class="shortcut">Prerequisites</a>
33                    | 
34                   <a href="#ExampleObject.implementations" class="shortcut">Known Implementations</a>
35                    | 
36                   <a href="#ExampleObject.properties" class="shortcut">Properties</a>
37 </td></tr>
38 </table>
39 <div class="refentry">
40 <a name="ExampleObject"></a><div class="titlepage"></div>
41 <div class="refnamediv"><table width="100%"><tr>
42 <td valign="top">
43 <h2><span class="refentrytitle"><a name="ExampleObject.top_of_page"></a>ExampleObject</span></h2>
44 <p>ExampleObject — Specialized GDBusObject types</p>
45 </td>
46 <td valign="top" align="right"></td>
47 </tr></table></div>
48 <div class="refsynopsisdiv">
49 <a name="ExampleObject.synopsis"></a><h2>Synopsis</h2>
50 <a name="ExampleObjectProxy"></a><a name="ExampleObjectSkeleton"></a><pre class="synopsis">                    <a class="link" href="ExampleObject.html#ExampleObject-struct" title="ExampleObject">ExampleObject</a>;
51 struct              <a class="link" href="ExampleObject.html#ExampleObjectIface" title="struct ExampleObjectIface">ExampleObjectIface</a>;
52 <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> *     <a class="link" href="ExampleObject.html#example-object-get-animal" title="example_object_get_animal ()">example_object_get_animal</a>           (<em class="parameter"><code><a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a> *object</code></em>);
53 <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        <a class="link" href="ExampleObject.html#example-object-get-cat" title="example_object_get_cat ()">example_object_get_cat</a>              (<em class="parameter"><code><a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a> *object</code></em>);
54 <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> *     <a class="link" href="ExampleObject.html#example-object-peek-animal" title="example_object_peek_animal ()">example_object_peek_animal</a>          (<em class="parameter"><code><a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a> *object</code></em>);
55 <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        <a class="link" href="ExampleObject.html#example-object-peek-cat" title="example_object_peek_cat ()">example_object_peek_cat</a>             (<em class="parameter"><code><a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a> *object</code></em>);
56 struct              <a class="link" href="ExampleObject.html#ExampleObjectProxy-struct" title="struct ExampleObjectProxy">ExampleObjectProxy</a>;
57 struct              <a class="link" href="ExampleObject.html#ExampleObjectProxyClass" title="struct ExampleObjectProxyClass">ExampleObjectProxyClass</a>;
58 <a class="link" href="ExampleObject.html#ExampleObjectProxy"><span class="returnvalue">ExampleObjectProxy</span></a> * <a class="link" href="ExampleObject.html#example-object-proxy-new" title="example_object_proxy_new ()">example_object_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>,
59                                                          <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>);
60 struct              <a class="link" href="ExampleObject.html#ExampleObjectSkeleton-struct" title="struct ExampleObjectSkeleton">ExampleObjectSkeleton</a>;
61 struct              <a class="link" href="ExampleObject.html#ExampleObjectSkeletonClass" title="struct ExampleObjectSkeletonClass">ExampleObjectSkeletonClass</a>;
62 <a class="link" href="ExampleObject.html#ExampleObjectSkeleton"><span class="returnvalue">ExampleObjectSkeleton</span></a> * <a class="link" href="ExampleObject.html#example-object-skeleton-new" title="example_object_skeleton_new ()">example_object_skeleton_new</a>     (<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>);
63 <span class="returnvalue">void</span>                <a class="link" href="ExampleObject.html#example-object-skeleton-set-animal" title="example_object_skeleton_set_animal ()">example_object_skeleton_set_animal</a>  (<em class="parameter"><code><a class="link" href="ExampleObject.html#ExampleObjectSkeleton"><span class="type">ExampleObjectSkeleton</span></a> *object</code></em>,
64                                                          <em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *interface_</code></em>);
65 <span class="returnvalue">void</span>                <a class="link" href="ExampleObject.html#example-object-skeleton-set-cat" title="example_object_skeleton_set_cat ()">example_object_skeleton_set_cat</a>     (<em class="parameter"><code><a class="link" href="ExampleObject.html#ExampleObjectSkeleton"><span class="type">ExampleObjectSkeleton</span></a> *object</code></em>,
66                                                          <em class="parameter"><code><a class="link" href="ExampleCat.html" title="ExampleCat"><span class="type">ExampleCat</span></a> *interface_</code></em>);
67 </pre>
68 </div>
69 <div class="refsect1">
70 <a name="ExampleObject.object-hierarchy"></a><h2>Object Hierarchy</h2>
71 <pre class="synopsis">
72   GInterface
73    +----ExampleObject
74 </pre>
75 <pre class="synopsis">
76   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
77    +----<a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectProxy.html">GDBusObjectProxy</a>
78          +----ExampleObjectProxy
79 </pre>
80 <pre class="synopsis">
81   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
82    +----<a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectSkeleton.html">GDBusObjectSkeleton</a>
83          +----ExampleObjectSkeleton
84 </pre>
85 </div>
86 <div class="refsect1">
87 <a name="ExampleObject.prerequisites"></a><h2>Prerequisites</h2>
88 <p>
89 ExampleObject requires
90  <a href="http://library.gnome.org/devel/gio/unstable/GDBusObject.html">GDBusObject</a> and  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
91 </div>
92 <div class="refsect1">
93 <a name="ExampleObject.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
94 <p>
95 ExampleObjectProxy implements
96  <a href="http://library.gnome.org/devel/gio/unstable/GDBusObject.html">GDBusObject</a> and  <a class="link" href="ExampleObject.html" title="ExampleObject">ExampleObject</a>.</p>
97 <p>
98 ExampleObjectSkeleton implements
99  <a href="http://library.gnome.org/devel/gio/unstable/GDBusObject.html">GDBusObject</a> and  <a class="link" href="ExampleObject.html" title="ExampleObject">ExampleObject</a>.</p>
100 </div>
101 <div class="refsect1">
102 <a name="ExampleObject.implementations"></a><h2>Known Implementations</h2>
103 <p>
104 ExampleObject is implemented by
105  <a class="link" href="ExampleObject.html#ExampleObjectProxy">ExampleObjectProxy</a> and  <a class="link" href="ExampleObject.html#ExampleObjectSkeleton">ExampleObjectSkeleton</a>.</p>
106 </div>
107 <div class="refsect1">
108 <a name="ExampleObject.properties"></a><h2>Properties</h2>
109 <pre class="synopsis">
110   "<a class="link" href="ExampleObject.html#ExampleObject--animal" title='The "animal" property'>animal</a>"                   <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a>*        : Read / Write
111   "<a class="link" href="ExampleObject.html#ExampleObject--cat" title='The "cat" property'>cat</a>"                      <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="type">ExampleCat</span></a>*           : Read / Write
112 </pre>
113 </div>
114 <div class="refsect1">
115 <a name="ExampleObject.description"></a><h2>Description</h2>
116 <p>
117 This section contains the <a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a>, <a class="link" href="ExampleObject.html#ExampleObjectProxy"><span class="type">ExampleObjectProxy</span></a>, and <a class="link" href="ExampleObject.html#ExampleObjectSkeleton"><span class="type">ExampleObjectSkeleton</span></a> types which make it easier to work with objects implementing generated types for D-Bus interfaces.
118 </p>
119 </div>
120 <div class="refsect1">
121 <a name="ExampleObject.details"></a><h2>Details</h2>
122 <div class="refsect2">
123 <a name="ExampleObject-struct"></a><h3>ExampleObject</h3>
124 <pre class="programlisting">typedef struct _ExampleObject ExampleObject;</pre>
125 <p>
126 The <a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a> type is a specialized container of interfaces.
127 </p>
128 </div>
129 <hr>
130 <div class="refsect2">
131 <a name="ExampleObjectIface"></a><h3>struct ExampleObjectIface</h3>
132 <pre class="programlisting">struct ExampleObjectIface {
133   GTypeInterface parent_iface;
134 };
135 </pre>
136 <p>
137 Virtual table for the <a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a> interface.
138 </p>
139 <div class="variablelist"><table border="0">
140 <col align="left" valign="top">
141 <tbody><tr>
142 <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="ExampleObjectIface.parent-iface"></a>parent_iface</code></em>;</span></p></td>
143 <td>The parent interface.</td>
144 </tr></tbody>
145 </table></div>
146 </div>
147 <hr>
148 <div class="refsect2">
149 <a name="example-object-get-animal"></a><h3>example_object_get_animal ()</h3>
150 <pre class="programlisting"><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> *     example_object_get_animal           (<em class="parameter"><code><a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a> *object</code></em>);</pre>
151 <p>
152 Gets the <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> instance for the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Animal on <em class="parameter"><code>object</code></em>, if any.
153 </p>
154 <div class="variablelist"><table border="0">
155 <col align="left" valign="top">
156 <tbody>
157 <tr>
158 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
159 <td>A <a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a>.</td>
160 </tr>
161 <tr>
162 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
163 <td>A <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> that must be freed with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> 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>object</code></em> does not implement the interface. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
164 </td>
165 </tr>
166 </tbody>
167 </table></div>
168 <p class="since">Since 2.30</p>
169 </div>
170 <hr>
171 <div class="refsect2">
172 <a name="example-object-get-cat"></a><h3>example_object_get_cat ()</h3>
173 <pre class="programlisting"><a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        example_object_get_cat              (<em class="parameter"><code><a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a> *object</code></em>);</pre>
174 <p>
175 Gets the <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="type">ExampleCat</span></a> instance for the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Cat on <em class="parameter"><code>object</code></em>, if any.
176 </p>
177 <div class="variablelist"><table border="0">
178 <col align="left" valign="top">
179 <tbody>
180 <tr>
181 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
182 <td>A <a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a>.</td>
183 </tr>
184 <tr>
185 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
186 <td>A <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="type">ExampleCat</span></a> that must be freed with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> 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>object</code></em> does not implement the interface. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
187 </td>
188 </tr>
189 </tbody>
190 </table></div>
191 </div>
192 <hr>
193 <div class="refsect2">
194 <a name="example-object-peek-animal"></a><h3>example_object_peek_animal ()</h3>
195 <pre class="programlisting"><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="returnvalue">ExampleAnimal</span></a> *     example_object_peek_animal          (<em class="parameter"><code><a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a> *object</code></em>);</pre>
196 <p>
197 Like <a class="link" href="ExampleObject.html#example-object-get-animal" title="example_object_get_animal ()"><code class="function">example_object_get_animal()</code></a> but doesn't increase the reference count on the returned object.
198 </p>
199 <p>
200 </p>
201 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
202 <h3 class="title">Warning</h3>It is not safe to use the returned object if you are on another thread than the one where the <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html"><span class="type">GDBusObjectManagerClient</span></a> or <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerServer.html"><span class="type">GDBusObjectManagerServer</span></a> for <em class="parameter"><code>object</code></em> is running.</div>
203 <p>
204 </p>
205 <div class="variablelist"><table border="0">
206 <col align="left" valign="top">
207 <tbody>
208 <tr>
209 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
210 <td>A <a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a>.</td>
211 </tr>
212 <tr>
213 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
214 <td>A <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> 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>object</code></em> does not implement the interface. Do not free the returned object, it is owned by <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>
215 </td>
216 </tr>
217 </tbody>
218 </table></div>
219 <p class="since">Since 2.30</p>
220 </div>
221 <hr>
222 <div class="refsect2">
223 <a name="example-object-peek-cat"></a><h3>example_object_peek_cat ()</h3>
224 <pre class="programlisting"><a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        example_object_peek_cat             (<em class="parameter"><code><a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a> *object</code></em>);</pre>
225 <p>
226 Like <a class="link" href="ExampleObject.html#example-object-get-cat" title="example_object_get_cat ()"><code class="function">example_object_get_cat()</code></a> but doesn't increase the reference count on the returned object.
227 </p>
228 <p>
229 </p>
230 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
231 <h3 class="title">Warning</h3>It is not safe to use the returned object if you are on another thread than the one where the <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerClient.html"><span class="type">GDBusObjectManagerClient</span></a> or <a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectManagerServer.html"><span class="type">GDBusObjectManagerServer</span></a> for <em class="parameter"><code>object</code></em> is running.</div>
232 <p>
233 </p>
234 <div class="variablelist"><table border="0">
235 <col align="left" valign="top">
236 <tbody>
237 <tr>
238 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
239 <td>A <a class="link" href="ExampleObject.html" title="ExampleObject"><span class="type">ExampleObject</span></a>.</td>
240 </tr>
241 <tr>
242 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
243 <td>A <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="type">ExampleCat</span></a> 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>object</code></em> does not implement the interface. Do not free the returned object, it is owned by <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>
244 </td>
245 </tr>
246 </tbody>
247 </table></div>
248 </div>
249 <hr>
250 <div class="refsect2">
251 <a name="ExampleObjectProxy-struct"></a><h3>struct ExampleObjectProxy</h3>
252 <pre class="programlisting">struct ExampleObjectProxy;</pre>
253 <p>
254 The <a class="link" href="ExampleObject.html#ExampleObjectProxy"><span class="type">ExampleObjectProxy</span></a> structure contains only private data and should only be accessed using the provided API.
255 </p>
256 </div>
257 <hr>
258 <div class="refsect2">
259 <a name="ExampleObjectProxyClass"></a><h3>struct ExampleObjectProxyClass</h3>
260 <pre class="programlisting">struct ExampleObjectProxyClass {
261   GDBusObjectProxyClass parent_class;
262 };
263 </pre>
264 <p>
265 Class structure for <a class="link" href="ExampleObject.html#ExampleObjectProxy"><span class="type">ExampleObjectProxy</span></a>.
266 </p>
267 <div class="variablelist"><table border="0">
268 <col align="left" valign="top">
269 <tbody><tr>
270 <td><p><span class="term"><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectProxy.html#GDBusObjectProxyClass"><span class="type">GDBusObjectProxyClass</span></a> <em class="structfield"><code><a name="ExampleObjectProxyClass.parent-class"></a>parent_class</code></em>;</span></p></td>
271 <td>The parent class.</td>
272 </tr></tbody>
273 </table></div>
274 </div>
275 <hr>
276 <div class="refsect2">
277 <a name="example-object-proxy-new"></a><h3>example_object_proxy_new ()</h3>
278 <pre class="programlisting"><a class="link" href="ExampleObject.html#ExampleObjectProxy"><span class="returnvalue">ExampleObjectProxy</span></a> * example_object_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>,
279                                                          <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>);</pre>
280 <p>
281 Creates a new proxy object.
282 </p>
283 <div class="variablelist"><table border="0">
284 <col align="left" valign="top">
285 <tbody>
286 <tr>
287 <td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
288 <td>A <a href="http://library.gnome.org/devel/gio/unstable/GDBusConnection.html"><span class="type">GDBusConnection</span></a>.</td>
289 </tr>
290 <tr>
291 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
292 <td>An object path.</td>
293 </tr>
294 <tr>
295 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
296 <td>The proxy object. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
297 </td>
298 </tr>
299 </tbody>
300 </table></div>
301 </div>
302 <hr>
303 <div class="refsect2">
304 <a name="ExampleObjectSkeleton-struct"></a><h3>struct ExampleObjectSkeleton</h3>
305 <pre class="programlisting">struct ExampleObjectSkeleton;</pre>
306 <p>
307 The <a class="link" href="ExampleObject.html#ExampleObjectSkeleton"><span class="type">ExampleObjectSkeleton</span></a> structure contains only private data and should only be accessed using the provided API.
308 </p>
309 </div>
310 <hr>
311 <div class="refsect2">
312 <a name="ExampleObjectSkeletonClass"></a><h3>struct ExampleObjectSkeletonClass</h3>
313 <pre class="programlisting">struct ExampleObjectSkeletonClass {
314   GDBusObjectSkeletonClass parent_class;
315 };
316 </pre>
317 <p>
318 Class structure for <a class="link" href="ExampleObject.html#ExampleObjectSkeleton"><span class="type">ExampleObjectSkeleton</span></a>.
319 </p>
320 <div class="variablelist"><table border="0">
321 <col align="left" valign="top">
322 <tbody><tr>
323 <td><p><span class="term"><a href="http://library.gnome.org/devel/gio/unstable/GDBusObjectSkeleton.html#GDBusObjectSkeletonClass"><span class="type">GDBusObjectSkeletonClass</span></a> <em class="structfield"><code><a name="ExampleObjectSkeletonClass.parent-class"></a>parent_class</code></em>;</span></p></td>
324 <td>The parent class.</td>
325 </tr></tbody>
326 </table></div>
327 </div>
328 <hr>
329 <div class="refsect2">
330 <a name="example-object-skeleton-new"></a><h3>example_object_skeleton_new ()</h3>
331 <pre class="programlisting"><a class="link" href="ExampleObject.html#ExampleObjectSkeleton"><span class="returnvalue">ExampleObjectSkeleton</span></a> * example_object_skeleton_new     (<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>);</pre>
332 <p>
333 Creates a new skeleton object.
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>object_path</code></em> :</span></p></td>
340 <td>An object path.</td>
341 </tr>
342 <tr>
343 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
344 <td>The skeleton object. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
345 </td>
346 </tr>
347 </tbody>
348 </table></div>
349 </div>
350 <hr>
351 <div class="refsect2">
352 <a name="example-object-skeleton-set-animal"></a><h3>example_object_skeleton_set_animal ()</h3>
353 <pre class="programlisting"><span class="returnvalue">void</span>                example_object_skeleton_set_animal  (<em class="parameter"><code><a class="link" href="ExampleObject.html#ExampleObjectSkeleton"><span class="type">ExampleObjectSkeleton</span></a> *object</code></em>,
354                                                          <em class="parameter"><code><a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> *interface_</code></em>);</pre>
355 <p>
356 Sets the <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> instance for the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Animal on <em class="parameter"><code>object</code></em>.
357 </p>
358 <div class="variablelist"><table border="0">
359 <col align="left" valign="top">
360 <tbody>
361 <tr>
362 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
363 <td>A <a class="link" href="ExampleObject.html#ExampleObjectSkeleton"><span class="type">ExampleObjectSkeleton</span></a>.</td>
364 </tr>
365 <tr>
366 <td><p><span class="term"><em class="parameter"><code>interface_</code></em> :</span></p></td>
367 <td>A <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to clear the interface. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
368 </td>
369 </tr>
370 </tbody>
371 </table></div>
372 <p class="since">Since 2.30</p>
373 </div>
374 <hr>
375 <div class="refsect2">
376 <a name="example-object-skeleton-set-cat"></a><h3>example_object_skeleton_set_cat ()</h3>
377 <pre class="programlisting"><span class="returnvalue">void</span>                example_object_skeleton_set_cat     (<em class="parameter"><code><a class="link" href="ExampleObject.html#ExampleObjectSkeleton"><span class="type">ExampleObjectSkeleton</span></a> *object</code></em>,
378                                                          <em class="parameter"><code><a class="link" href="ExampleCat.html" title="ExampleCat"><span class="type">ExampleCat</span></a> *interface_</code></em>);</pre>
379 <p>
380 Sets the <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="type">ExampleCat</span></a> instance for the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Cat on <em class="parameter"><code>object</code></em>.
381 </p>
382 <div class="variablelist"><table border="0">
383 <col align="left" valign="top">
384 <tbody>
385 <tr>
386 <td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td>
387 <td>A <a class="link" href="ExampleObject.html#ExampleObjectSkeleton"><span class="type">ExampleObjectSkeleton</span></a>.</td>
388 </tr>
389 <tr>
390 <td><p><span class="term"><em class="parameter"><code>interface_</code></em> :</span></p></td>
391 <td>A <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="type">ExampleCat</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to clear the interface. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
392 </td>
393 </tr>
394 </tbody>
395 </table></div>
396 </div>
397 </div>
398 <div class="refsect1">
399 <a name="ExampleObject.property-details"></a><h2>Property Details</h2>
400 <div class="refsect2">
401 <a name="ExampleObject--animal"></a><h3>The <code class="literal">"animal"</code> property</h3>
402 <pre class="programlisting">  "animal"                   <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a>*        : Read / Write</pre>
403 <p>
404 The <a class="link" href="ExampleAnimal.html" title="ExampleAnimal"><span class="type">ExampleAnimal</span></a> instance corresponding to the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Animal, if any.
405 </p>
406 <p>
407 Connect to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal to get informed of property changes.
408 </p>
409 <p class="since">Since 2.30</p>
410 </div>
411 <hr>
412 <div class="refsect2">
413 <a name="ExampleObject--cat"></a><h3>The <code class="literal">"cat"</code> property</h3>
414 <pre class="programlisting">  "cat"                      <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="type">ExampleCat</span></a>*           : Read / Write</pre>
415 <p>
416 The <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="type">ExampleCat</span></a> instance corresponding to the D-Bus interface org.gtk.GDBus.Example.ObjectManager.Cat, if any.
417 </p>
418 <p>
419 Connect to the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-notify"><span class="type">"notify"</span></a> signal to get informed of property changes.
420 </p>
421 </div>
422 </div>
423 </div>
424 <div class="footer">
425 <hr>
426           Generated by GTK-Doc V1.18</div>
427 </body>
428 </html>