Moving files to packaging and extracing new tarball.
[profile/ivi/glib2.git] / docs / reference / gio / html / ExampleCat.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>ExampleCat</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GIO Reference Manual">
8 <link rel="up" href="ch30s05.html" title="Generating code and docs">
9 <link rel="prev" href="ExampleAnimal.html" title="ExampleAnimal">
10 <link rel="next" href="ExampleObject.html" title="ExampleObject">
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="ExampleAnimal.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="ch30s05.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GIO Reference Manual</th>
21 <td><a accesskey="n" href="ExampleObject.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="#ExampleCat.synopsis" class="shortcut">Top</a>
25                    | 
26                   <a href="#ExampleCat.description" class="shortcut">Description</a>
27                    | 
28                   <a href="#ExampleCat.object-hierarchy" class="shortcut">Object Hierarchy</a>
29                    | 
30                   <a href="#ExampleCat.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
31                    | 
32                   <a href="#ExampleCat.prerequisites" class="shortcut">Prerequisites</a>
33                    | 
34                   <a href="#ExampleCat.implementations" class="shortcut">Known Implementations</a>
35 </td></tr>
36 </table>
37 <div class="refentry">
38 <a name="ExampleCat"></a><div class="titlepage"></div>
39 <div class="refnamediv"><table width="100%"><tr>
40 <td valign="top">
41 <h2><span class="refentrytitle"><a name="ExampleCat.top_of_page"></a>ExampleCat</span></h2>
42 <p>ExampleCat — Generated C code for the org.gtk.GDBus.Example.ObjectManager.Cat D-Bus interface</p>
43 </td>
44 <td valign="top" align="right"></td>
45 </tr></table></div>
46 <div class="refsynopsisdiv">
47 <a name="ExampleCat.synopsis"></a><h2>Synopsis</h2>
48 <a name="ExampleCatProxy"></a><a name="ExampleCatSkeleton"></a><pre class="synopsis">                    <a class="link" href="ExampleCat.html#ExampleCat-struct" title="ExampleCat">ExampleCat</a>;
49 struct              <a class="link" href="ExampleCat.html#ExampleCatIface" title="struct ExampleCatIface">ExampleCatIface</a>;
50 <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="returnvalue">GDBusInterfaceInfo</span></a> * <a class="link" href="ExampleCat.html#example-cat-interface-info" title="example_cat_interface_info ()">example_cat_interface_info</a>         (<em class="parameter"><code><span class="type">void</span></code></em>);
51 <a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="ExampleCat.html#example-cat-override-properties" title="example_cat_override_properties ()">example_cat_override_properties</a>     (<em class="parameter"><code><a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *klass</code></em>,
52                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id_begin</code></em>);
53 struct              <a class="link" href="ExampleCat.html#ExampleCatProxy-struct" title="struct ExampleCatProxy">ExampleCatProxy</a>;
54 struct              <a class="link" href="ExampleCat.html#ExampleCatProxyClass" title="struct ExampleCatProxyClass">ExampleCatProxyClass</a>;
55 <span class="returnvalue">void</span>                <a class="link" href="ExampleCat.html#example-cat-proxy-new" title="example_cat_proxy_new ()">example_cat_proxy_new</a>               (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
56                                                          <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
57                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
58                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
59                                                          <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
60                                                          <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
61                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
62 <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        <a class="link" href="ExampleCat.html#example-cat-proxy-new-finish" title="example_cat_proxy_new_finish ()">example_cat_proxy_new_finish</a>        (<em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
63                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
64 <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        <a class="link" href="ExampleCat.html#example-cat-proxy-new-sync" title="example_cat_proxy_new_sync ()">example_cat_proxy_new_sync</a>          (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
65                                                          <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
66                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
67                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
68                                                          <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
69                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
70 <span class="returnvalue">void</span>                <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus" title="example_cat_proxy_new_for_bus ()">example_cat_proxy_new_for_bus</a>       (<em class="parameter"><code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
71                                                          <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
72                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
73                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
74                                                          <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
75                                                          <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
76                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
77 <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus-finish" title="example_cat_proxy_new_for_bus_finish ()">example_cat_proxy_new_for_bus_finish</a>
78                                                         (<em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
79                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
80 <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus-sync" title="example_cat_proxy_new_for_bus_sync ()">example_cat_proxy_new_for_bus_sync</a>  (<em class="parameter"><code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
81                                                          <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
82                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
83                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
84                                                          <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
85                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
86 struct              <a class="link" href="ExampleCat.html#ExampleCatSkeleton-struct" title="struct ExampleCatSkeleton">ExampleCatSkeleton</a>;
87 struct              <a class="link" href="ExampleCat.html#ExampleCatSkeletonClass" title="struct ExampleCatSkeletonClass">ExampleCatSkeletonClass</a>;
88 <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        <a class="link" href="ExampleCat.html#example-cat-skeleton-new" title="example_cat_skeleton_new ()">example_cat_skeleton_new</a>            (<em class="parameter"><code><span class="type">void</span></code></em>);
89 </pre>
90 </div>
91 <div class="refsect1">
92 <a name="ExampleCat.object-hierarchy"></a><h2>Object Hierarchy</h2>
93 <pre class="synopsis">
94   GInterface
95    +----ExampleCat
96 </pre>
97 <pre class="synopsis">
98   <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
99    +----<a class="link" href="GDBusProxy.html" title="GDBusProxy">GDBusProxy</a>
100          +----ExampleCatProxy
101 </pre>
102 <pre class="synopsis">
103   <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
104    +----<a class="link" href="GDBusInterfaceSkeleton.html" title="GDBusInterfaceSkeleton">GDBusInterfaceSkeleton</a>
105          +----ExampleCatSkeleton
106 </pre>
107 </div>
108 <div class="refsect1">
109 <a name="ExampleCat.prerequisites"></a><h2>Prerequisites</h2>
110 <p>
111 ExampleCat requires
112  <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
113 </div>
114 <div class="refsect1">
115 <a name="ExampleCat.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
116 <p>
117 ExampleCatProxy implements
118  <a class="link" href="GDBusInterface.html" title="GDBusInterface">GDBusInterface</a>,  <a class="link" href="GInitable.html" title="GInitable">GInitable</a>,  <a class="link" href="GAsyncInitable.html" title="GAsyncInitable">GAsyncInitable</a> and  <a class="link" href="ExampleCat.html" title="ExampleCat">ExampleCat</a>.</p>
119 <p>
120 ExampleCatSkeleton implements
121  <a class="link" href="GDBusInterface.html" title="GDBusInterface">GDBusInterface</a> and  <a class="link" href="ExampleCat.html" title="ExampleCat">ExampleCat</a>.</p>
122 </div>
123 <div class="refsect1">
124 <a name="ExampleCat.implementations"></a><h2>Known Implementations</h2>
125 <p>
126 ExampleCat is implemented by
127  <a class="link" href="ExampleCat.html#ExampleCatProxy">ExampleCatProxy</a> and  <a class="link" href="ExampleCat.html#ExampleCatSkeleton">ExampleCatSkeleton</a>.</p>
128 </div>
129 <div class="refsect1">
130 <a name="ExampleCat.description"></a><h2>Description</h2>
131 <p>
132 This section contains code for working with the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Cat.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</a> D-Bus interface in C.
133 </p>
134 </div>
135 <div class="refsect1">
136 <a name="ExampleCat.details"></a><h2>Details</h2>
137 <div class="refsect2">
138 <a name="ExampleCat-struct"></a><h3>ExampleCat</h3>
139 <pre class="programlisting">typedef struct _ExampleCat ExampleCat;</pre>
140 <p>
141 Abstract interface type for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Cat.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</a>.
142 </p>
143 </div>
144 <hr>
145 <div class="refsect2">
146 <a name="ExampleCatIface"></a><h3>struct ExampleCatIface</h3>
147 <pre class="programlisting">struct ExampleCatIface {
148   GTypeInterface parent_iface;
149 };
150 </pre>
151 <p>
152 Virtual table for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Cat.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</a>.
153 </p>
154 <div class="variablelist"><table border="0">
155 <col align="left" valign="top">
156 <tbody><tr>
157 <td><p><span class="term"><a href="./../gobject/gobject/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="ExampleCatIface.parent-iface"></a>parent_iface</code></em>;</span></p></td>
158 <td>The parent interface.</td>
159 </tr></tbody>
160 </table></div>
161 </div>
162 <hr>
163 <div class="refsect2">
164 <a name="example-cat-interface-info"></a><h3>example_cat_interface_info ()</h3>
165 <pre class="programlisting"><a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="returnvalue">GDBusInterfaceInfo</span></a> * example_cat_interface_info         (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
166 <p>
167 Gets a machine-readable description of the <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Cat.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</a> D-Bus interface.
168 </p>
169 <div class="variablelist"><table border="0">
170 <col align="left" valign="top">
171 <tbody><tr>
172 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
173 <td>A <a class="link" href="gio-D-Bus-Introspection-Data.html#GDBusInterfaceInfo"><span class="type">GDBusInterfaceInfo</span></a>. Do not free. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
174 </td>
175 </tr></tbody>
176 </table></div>
177 </div>
178 <hr>
179 <div class="refsect2">
180 <a name="example-cat-override-properties"></a><h3>example_cat_override_properties ()</h3>
181 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               example_cat_override_properties     (<em class="parameter"><code><a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> *klass</code></em>,
182                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> property_id_begin</code></em>);</pre>
183 <p>
184 Overrides all <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> properties in the <a class="link" href="ExampleCat.html" title="ExampleCat"><span class="type">ExampleCat</span></a> interface for a concrete class.
185 The properties are overridden in the order they are defined.
186 </p>
187 <div class="variablelist"><table border="0">
188 <col align="left" valign="top">
189 <tbody>
190 <tr>
191 <td><p><span class="term"><em class="parameter"><code>klass</code></em> :</span></p></td>
192 <td>The class structure for a <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>-derived class.</td>
193 </tr>
194 <tr>
195 <td><p><span class="term"><em class="parameter"><code>property_id_begin</code></em> :</span></p></td>
196 <td>The property id to assign to the first overridden property.</td>
197 </tr>
198 <tr>
199 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
200 <td>The last property id.</td>
201 </tr>
202 </tbody>
203 </table></div>
204 </div>
205 <hr>
206 <div class="refsect2">
207 <a name="ExampleCatProxy-struct"></a><h3>struct ExampleCatProxy</h3>
208 <pre class="programlisting">struct ExampleCatProxy;</pre>
209 <p>
210 The <a class="link" href="ExampleCat.html#ExampleCatProxy"><span class="type">ExampleCatProxy</span></a> structure contains only private data and should only be accessed using the provided API.
211 </p>
212 </div>
213 <hr>
214 <div class="refsect2">
215 <a name="ExampleCatProxyClass"></a><h3>struct ExampleCatProxyClass</h3>
216 <pre class="programlisting">struct ExampleCatProxyClass {
217   GDBusProxyClass parent_class;
218 };
219 </pre>
220 <p>
221 Class structure for <a class="link" href="ExampleCat.html#ExampleCatProxy"><span class="type">ExampleCatProxy</span></a>.
222 </p>
223 <div class="variablelist"><table border="0">
224 <col align="left" valign="top">
225 <tbody><tr>
226 <td><p><span class="term"><a class="link" href="GDBusProxy.html#GDBusProxyClass" title="struct GDBusProxyClass"><span class="type">GDBusProxyClass</span></a> <em class="structfield"><code><a name="ExampleCatProxyClass.parent-class"></a>parent_class</code></em>;</span></p></td>
227 <td>The parent class.</td>
228 </tr></tbody>
229 </table></div>
230 </div>
231 <hr>
232 <div class="refsect2">
233 <a name="example-cat-proxy-new"></a><h3>example_cat_proxy_new ()</h3>
234 <pre class="programlisting"><span class="returnvalue">void</span>                example_cat_proxy_new               (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
235                                                          <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
236                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
237                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
238                                                          <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
239                                                          <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
240                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
241 <p>
242 Asynchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Cat.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</a>. See <a class="link" href="GDBusProxy.html#g-dbus-proxy-new" title="g_dbus_proxy_new ()"><code class="function">g_dbus_proxy_new()</code></a> for more details.
243 </p>
244 <p>
245 When the operation is finished, <em class="parameter"><code>callback</code></em> will be invoked in the <a href="./../glib/glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
246 You can then call <a class="link" href="ExampleCat.html#example-cat-proxy-new-finish" title="example_cat_proxy_new_finish ()"><code class="function">example_cat_proxy_new_finish()</code></a> to get the result of the operation.
247 </p>
248 <p>
249 See <a class="link" href="ExampleCat.html#example-cat-proxy-new-sync" title="example_cat_proxy_new_sync ()"><code class="function">example_cat_proxy_new_sync()</code></a> for the synchronous, blocking version of this constructor.
250 </p>
251 <div class="variablelist"><table border="0">
252 <col align="left" valign="top">
253 <tbody>
254 <tr>
255 <td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
256 <td>A <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>.</td>
257 </tr>
258 <tr>
259 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
260 <td>Flags from the <a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
261 </tr>
262 <tr>
263 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
264 <td>A bus name (well-known or unique) or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em> is not a message bus connection. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
265 </td>
266 </tr>
267 <tr>
268 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
269 <td>An object path.</td>
270 </tr>
271 <tr>
272 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
273 <td>A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
274 </td>
275 </tr>
276 <tr>
277 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
278 <td>A <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</td>
279 </tr>
280 <tr>
281 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
282 <td>User data to pass to <em class="parameter"><code>callback</code></em>.</td>
283 </tr>
284 </tbody>
285 </table></div>
286 </div>
287 <hr>
288 <div class="refsect2">
289 <a name="example-cat-proxy-new-finish"></a><h3>example_cat_proxy_new_finish ()</h3>
290 <pre class="programlisting"><a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        example_cat_proxy_new_finish        (<em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
291                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
292 <p>
293 Finishes an operation started with <a class="link" href="ExampleCat.html#example-cat-proxy-new" title="example_cat_proxy_new ()"><code class="function">example_cat_proxy_new()</code></a>.
294 </p>
295 <div class="variablelist"><table border="0">
296 <col align="left" valign="top">
297 <tbody>
298 <tr>
299 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
300 <td>The <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> obtained from the <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="ExampleCat.html#example-cat-proxy-new" title="example_cat_proxy_new ()"><code class="function">example_cat_proxy_new()</code></a>.</td>
301 </tr>
302 <tr>
303 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
304 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
305 </td>
306 </tr>
307 <tr>
308 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
309 <td>The constructed proxy object or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> ExampleCatProxy]</span>
310 </td>
311 </tr>
312 </tbody>
313 </table></div>
314 </div>
315 <hr>
316 <div class="refsect2">
317 <a name="example-cat-proxy-new-sync"></a><h3>example_cat_proxy_new_sync ()</h3>
318 <pre class="programlisting"><a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        example_cat_proxy_new_sync          (<em class="parameter"><code><a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a> *connection</code></em>,
319                                                          <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
320                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
321                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
322                                                          <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
323                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
324 <p>
325 Synchronously creates a proxy for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Cat.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</a>. See <a class="link" href="GDBusProxy.html#g-dbus-proxy-new-sync" title="g_dbus_proxy_new_sync ()"><code class="function">g_dbus_proxy_new_sync()</code></a> for more details.
326 </p>
327 <p>
328 The calling thread is blocked until a reply is received.
329 </p>
330 <p>
331 See <a class="link" href="ExampleCat.html#example-cat-proxy-new" title="example_cat_proxy_new ()"><code class="function">example_cat_proxy_new()</code></a> for the asynchronous version of this constructor.
332 </p>
333 <div class="variablelist"><table border="0">
334 <col align="left" valign="top">
335 <tbody>
336 <tr>
337 <td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
338 <td>A <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>.</td>
339 </tr>
340 <tr>
341 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
342 <td>Flags from the <a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
343 </tr>
344 <tr>
345 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
346 <td>A bus name (well-known or unique) or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>connection</code></em> is not a message bus connection. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
347 </td>
348 </tr>
349 <tr>
350 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
351 <td>An object path.</td>
352 </tr>
353 <tr>
354 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
355 <td>A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
356 </td>
357 </tr>
358 <tr>
359 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
360 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
361 </td>
362 </tr>
363 <tr>
364 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
365 <td>The constructed proxy object or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> ExampleCatProxy]</span>
366 </td>
367 </tr>
368 </tbody>
369 </table></div>
370 </div>
371 <hr>
372 <div class="refsect2">
373 <a name="example-cat-proxy-new-for-bus"></a><h3>example_cat_proxy_new_for_bus ()</h3>
374 <pre class="programlisting"><span class="returnvalue">void</span>                example_cat_proxy_new_for_bus       (<em class="parameter"><code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
375                                                          <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
376                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
377                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
378                                                          <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
379                                                          <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
380                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
381 <p>
382 Like <a class="link" href="ExampleCat.html#example-cat-proxy-new" title="example_cat_proxy_new ()"><code class="function">example_cat_proxy_new()</code></a> but takes a <a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> instead of a <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>.
383 </p>
384 <p>
385 When the operation is finished, <em class="parameter"><code>callback</code></em> will be invoked in the <a href="./../glib/glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main loop</a> of the thread you are calling this method from.
386 You can then call <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus-finish" title="example_cat_proxy_new_for_bus_finish ()"><code class="function">example_cat_proxy_new_for_bus_finish()</code></a> to get the result of the operation.
387 </p>
388 <p>
389 See <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus-sync" title="example_cat_proxy_new_for_bus_sync ()"><code class="function">example_cat_proxy_new_for_bus_sync()</code></a> for the synchronous, blocking version of this constructor.
390 </p>
391 <div class="variablelist"><table border="0">
392 <col align="left" valign="top">
393 <tbody>
394 <tr>
395 <td><p><span class="term"><em class="parameter"><code>bus_type</code></em> :</span></p></td>
396 <td>A <a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a>.</td>
397 </tr>
398 <tr>
399 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
400 <td>Flags from the <a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
401 </tr>
402 <tr>
403 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
404 <td>A bus name (well-known or unique).</td>
405 </tr>
406 <tr>
407 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
408 <td>An object path.</td>
409 </tr>
410 <tr>
411 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
412 <td>A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
413 </td>
414 </tr>
415 <tr>
416 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
417 <td>A <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> to call when the request is satisfied.</td>
418 </tr>
419 <tr>
420 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
421 <td>User data to pass to <em class="parameter"><code>callback</code></em>.</td>
422 </tr>
423 </tbody>
424 </table></div>
425 </div>
426 <hr>
427 <div class="refsect2">
428 <a name="example-cat-proxy-new-for-bus-finish"></a><h3>example_cat_proxy_new_for_bus_finish ()</h3>
429 <pre class="programlisting"><a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        example_cat_proxy_new_for_bus_finish
430                                                         (<em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *res</code></em>,
431                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
432 <p>
433 Finishes an operation started with <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus" title="example_cat_proxy_new_for_bus ()"><code class="function">example_cat_proxy_new_for_bus()</code></a>.
434 </p>
435 <div class="variablelist"><table border="0">
436 <col align="left" valign="top">
437 <tbody>
438 <tr>
439 <td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
440 <td>The <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> obtained from the <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> passed to <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus" title="example_cat_proxy_new_for_bus ()"><code class="function">example_cat_proxy_new_for_bus()</code></a>.</td>
441 </tr>
442 <tr>
443 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
444 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
445 </td>
446 </tr>
447 <tr>
448 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
449 <td>The constructed proxy object or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> ExampleCatProxy]</span>
450 </td>
451 </tr>
452 </tbody>
453 </table></div>
454 </div>
455 <hr>
456 <div class="refsect2">
457 <a name="example-cat-proxy-new-for-bus-sync"></a><h3>example_cat_proxy_new_for_bus_sync ()</h3>
458 <pre class="programlisting"><a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        example_cat_proxy_new_for_bus_sync  (<em class="parameter"><code><a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> bus_type</code></em>,
459                                                          <em class="parameter"><code><a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> flags</code></em>,
460                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
461                                                          <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *object_path</code></em>,
462                                                          <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
463                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
464 <p>
465 Like <a class="link" href="ExampleCat.html#example-cat-proxy-new-sync" title="example_cat_proxy_new_sync ()"><code class="function">example_cat_proxy_new_sync()</code></a> but takes a <a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a> instead of a <a class="link" href="GDBusConnection.html" title="GDBusConnection"><span class="type">GDBusConnection</span></a>.
466 </p>
467 <p>
468 The calling thread is blocked until a reply is received.
469 </p>
470 <p>
471 See <a class="link" href="ExampleCat.html#example-cat-proxy-new-for-bus" title="example_cat_proxy_new_for_bus ()"><code class="function">example_cat_proxy_new_for_bus()</code></a> for the asynchronous version of this constructor.
472 </p>
473 <div class="variablelist"><table border="0">
474 <col align="left" valign="top">
475 <tbody>
476 <tr>
477 <td><p><span class="term"><em class="parameter"><code>bus_type</code></em> :</span></p></td>
478 <td>A <a class="link" href="GDBusConnection.html#GBusType" title="enum GBusType"><span class="type">GBusType</span></a>.</td>
479 </tr>
480 <tr>
481 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
482 <td>Flags from the <a class="link" href="GDBusProxy.html#GDBusProxyFlags" title="enum GDBusProxyFlags"><span class="type">GDBusProxyFlags</span></a> enumeration.</td>
483 </tr>
484 <tr>
485 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
486 <td>A bus name (well-known or unique).</td>
487 </tr>
488 <tr>
489 <td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
490 <td>An object path.</td>
491 </tr>
492 <tr>
493 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
494 <td>A <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
495 </td>
496 </tr>
497 <tr>
498 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
499 <td>Return location for error or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
500 </td>
501 </tr>
502 <tr>
503 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
504 <td>The constructed proxy object or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> ExampleCatProxy]</span>
505 </td>
506 </tr>
507 </tbody>
508 </table></div>
509 </div>
510 <hr>
511 <div class="refsect2">
512 <a name="ExampleCatSkeleton-struct"></a><h3>struct ExampleCatSkeleton</h3>
513 <pre class="programlisting">struct ExampleCatSkeleton;</pre>
514 <p>
515 The <a class="link" href="ExampleCat.html#ExampleCatSkeleton"><span class="type">ExampleCatSkeleton</span></a> structure contains only private data and should only be accessed using the provided API.
516 </p>
517 </div>
518 <hr>
519 <div class="refsect2">
520 <a name="ExampleCatSkeletonClass"></a><h3>struct ExampleCatSkeletonClass</h3>
521 <pre class="programlisting">struct ExampleCatSkeletonClass {
522   GDBusInterfaceSkeletonClass parent_class;
523 };
524 </pre>
525 <p>
526 Class structure for <a class="link" href="ExampleCat.html#ExampleCatSkeleton"><span class="type">ExampleCatSkeleton</span></a>.
527 </p>
528 <div class="variablelist"><table border="0">
529 <col align="left" valign="top">
530 <tbody><tr>
531 <td><p><span class="term"><a class="link" href="GDBusInterfaceSkeleton.html#GDBusInterfaceSkeletonClass" title="struct GDBusInterfaceSkeletonClass"><span class="type">GDBusInterfaceSkeletonClass</span></a> <em class="structfield"><code><a name="ExampleCatSkeletonClass.parent-class"></a>parent_class</code></em>;</span></p></td>
532 <td>The parent class.</td>
533 </tr></tbody>
534 </table></div>
535 </div>
536 <hr>
537 <div class="refsect2">
538 <a name="example-cat-skeleton-new"></a><h3>example_cat_skeleton_new ()</h3>
539 <pre class="programlisting"><a class="link" href="ExampleCat.html" title="ExampleCat"><span class="returnvalue">ExampleCat</span></a> *        example_cat_skeleton_new            (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
540 <p>
541 Creates a skeleton object for the D-Bus interface <a class="link" href="gdbus-org.gtk.GDBus.Example.ObjectManager.Cat.html#gdbus-interface-org-gtk-GDBus-Example-ObjectManager-Cat.top_of_page">org.gtk.GDBus.Example.ObjectManager.Cat</a>.
542 </p>
543 <div class="variablelist"><table border="0">
544 <col align="left" valign="top">
545 <tbody><tr>
546 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
547 <td>The skeleton object. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> ExampleCatSkeleton]</span>
548 </td>
549 </tr></tbody>
550 </table></div>
551 </div>
552 </div>
553 </div>
554 <div class="footer">
555 <hr>
556           Generated by GTK-Doc V1.18</div>
557 </body>
558 </html>