~ubuntu-branches/ubuntu/oneiric/dbus-glib/oneiric-updates

« back to all changes in this revision

Viewing changes to doc/reference/html/dbus-glib-DBus-GObject-related-functions.html

  • Committer: Bazaar Package Importer
  • Author(s): Michael Biebl
  • Date: 2009-09-29 23:49:03 UTC
  • mfrom: (1.1.7 upstream) (2.1.6 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090929234903-oaprxcpac2lvd9hs
Tags: 0.82-2
* debian/patches/10_support_duplicate_object_registrations.patch
  - Pull patch from upstream git which allows duplicate object registrations
    and fixes a regression introduced in 0.82.
    (Closes: #540421, #541712, #542513, #544174, #546044)
* Bump Standards-Version to 3.8.3. No further changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>DBus GObject related functions</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
7
7
<link rel="home" href="index.html" title="D-Bus GLib bindings - Reference Manual">
8
8
<link rel="up" href="ch02.html" title="API Reference">
9
9
<link rel="prev" href="dbus-glib-DBusGConnection.html" title="DBusGConnection">
10
10
<link rel="next" href="dbus-glib-DBusGMessage.html" title="DBusGMessage">
11
 
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch01.html" title="Introduction">
14
14
<link rel="chapter" href="ch02.html" title="API Reference">
23
23
<th width="100%" align="center">D-Bus GLib bindings - Reference Manual</th>
24
24
<td><a accesskey="n" href="dbus-glib-DBusGMessage.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
25
25
</tr>
26
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#dbus-glib-DBus-GObject-related-functions.synopsis" class="shortcut">Top</a>
27
 
                   | 
28
 
                  <a href="#dbus-glib-DBus-GObject-related-functions.description" class="shortcut">Description</a></nobr></td></tr>
 
26
<tr><td colspan="5" class="shortcuts">
 
27
<a href="#dbus-glib-DBus-GObject-related-functions.synopsis" class="shortcut">Top</a>
 
28
                 | 
 
29
                <a href="#dbus-glib-DBus-GObject-related-functions.description" class="shortcut">Description</a>
 
30
</td></tr>
29
31
</table>
30
32
<div class="refentry" lang="en">
31
33
<a name="dbus-glib-DBus-GObject-related-functions"></a><div class="titlepage"></div>
33
35
<td valign="top">
34
36
<h2><span class="refentrytitle"><a name="dbus-glib-DBus-GObject-related-functions.top_of_page"></a>DBus GObject related functions</span></h2>
35
37
<p>DBus GObject related functions — Exporting a <a
36
 
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
 
38
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
37
39
><span class="type">GObject</span></a> remotely</p>
38
40
</td>
39
41
<td valign="top" align="right"></td>
45
47
<div class="refsynopsisdiv">
46
48
<a name="dbus-glib-DBus-GObject-related-functions.synopsis"></a><h2>Synopsis</h2>
47
49
<pre class="synopsis">
48
 
#define             <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#DBUS-TYPE-G-OBJECT-PATH:CAPS" title="DBUS_TYPE_G_OBJECT_PATH">DBUS_TYPE_G_OBJECT_PATH</a>
 
50
#define             <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#DBUS-TYPE-G-OBJECT-PATH--CAPS" title="DBUS_TYPE_G_OBJECT_PATH">DBUS_TYPE_G_OBJECT_PATH</a>
49
51
                    <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#DBusGObjectInfo" title="DBusGObjectInfo">DBusGObjectInfo</a>;
50
52
void                <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-type-install-info" title="dbus_g_object_type_install_info ()">dbus_g_object_type_install_info</a>     (<a
51
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
53
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
52
54
>GType</a> object_type,
53
55
                                                         const <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#DBusGObjectInfo" title="DBusGObjectInfo">DBusGObjectInfo</a> *info);
54
56
<a
55
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
57
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
56
58
>GType</a>               <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-path-get-g-type" title="dbus_g_object_path_get_g_type ()">dbus_g_object_path_get_g_type</a>       (void);
57
59
void                <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-register-marshaller" title="dbus_g_object_register_marshaller ()">dbus_g_object_register_marshaller</a>   (<a
58
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosureMarshal"
 
60
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"
59
61
>GClosureMarshal</a> marshaller,
60
62
                                                         <a
61
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
63
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
62
64
>GType</a> rettype,
63
65
                                                         ...);
64
66
void                <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-register-marshaller-array" title="dbus_g_object_register_marshaller_array ()">dbus_g_object_register_marshaller_array</a>
65
67
                                                        (<a
66
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosureMarshal"
 
68
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"
67
69
>GClosureMarshal</a> marshaller,
68
70
                                                         <a
69
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
71
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
70
72
>GType</a> rettype,
71
73
                                                         <a
72
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
 
74
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
73
75
>guint</a> n_types,
74
76
                                                         const <a
75
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
77
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
76
78
>GType</a> *types);
77
79
</pre>
78
80
</div>
81
83
<p>
82
84
FIXME</p>
83
85
<p>
84
 
 
85
86
</p>
86
87
</div>
87
88
<div class="refsect1" lang="en">
88
89
<a name="dbus-glib-DBus-GObject-related-functions.details"></a><h2>Details</h2>
89
90
<div class="refsect2" lang="en">
90
 
<a name="DBUS-TYPE-G-OBJECT-PATH:CAPS"></a><h3>DBUS_TYPE_G_OBJECT_PATH</h3>
 
91
<a name="DBUS-TYPE-G-OBJECT-PATH--CAPS"></a><h3>DBUS_TYPE_G_OBJECT_PATH</h3>
91
92
<pre class="programlisting">#define DBUS_TYPE_G_OBJECT_PATH (dbus_g_object_path_get_g_type ())
92
93
</pre>
93
94
<p>
94
 
 
95
95
</p>
96
96
</div>
97
97
<hr>
109
109
</pre>
110
110
<p>
111
111
Introspection data for a <a
112
 
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
 
112
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
113
113
><span class="type">GObject</span></a>, normally autogenerated by
114
114
a tool such as <a class="link" href="dbus-binding-tool.html" title="dbus-binding-tool"><span class="type">dbus-binding-tool</span></a>.</p>
115
115
<p>
116
 
 
117
116
</p>
118
117
<div class="variablelist"><table border="0">
119
118
<col align="left" valign="top">
156
155
<div class="refsect2" lang="en">
157
156
<a name="dbus-g-object-type-install-info"></a><h3>dbus_g_object_type_install_info ()</h3>
158
157
<pre class="programlisting">void                dbus_g_object_type_install_info     (<a
159
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
158
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
160
159
>GType</a> object_type,
161
160
                                                         const <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#DBusGObjectInfo" title="DBusGObjectInfo">DBusGObjectInfo</a> *info);</pre>
162
161
<p>
163
162
Install introspection information about the given object <a
164
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
163
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
165
164
><span class="type">GType</span></a>
166
165
sufficient to allow methods on the object to be invoked by name.
167
166
The introspection information is normally generated by
173
172
object registered with #<a class="link" href="dbus-glib-DBusGConnection.html#dbus-g-connection-register-g-object" title="dbus_g_connection_register_g_object ()"><code class="function">dbus_g_connection_register_g_object()</code></a> can have
174
173
their methods invoked remotely.</p>
175
174
<p>
176
 
 
177
175
</p>
178
176
<div class="variablelist"><table border="0">
179
177
<col align="left" valign="top">
181
179
<tr>
182
180
<td><p><span class="term"><em class="parameter"><code>object_type</code></em> :</span></p></td>
183
181
<td> <a
184
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
182
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
185
183
><span class="type">GType</span></a> for the object
186
184
</td>
187
185
</tr>
197
195
<div class="refsect2" lang="en">
198
196
<a name="dbus-g-object-path-get-g-type"></a><h3>dbus_g_object_path_get_g_type ()</h3>
199
197
<pre class="programlisting"><a
200
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
198
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
201
199
>GType</a>               dbus_g_object_path_get_g_type       (void);</pre>
202
200
<p>
203
 
 
204
201
</p>
205
202
<div class="variablelist"><table border="0">
206
203
<col align="left" valign="top">
207
204
<tbody><tr>
208
205
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
209
206
<td>
210
 
 
211
 
 
212
207
</td>
213
208
</tr></tbody>
214
209
</table></div>
217
212
<div class="refsect2" lang="en">
218
213
<a name="dbus-g-object-register-marshaller"></a><h3>dbus_g_object_register_marshaller ()</h3>
219
214
<pre class="programlisting">void                dbus_g_object_register_marshaller   (<a
220
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosureMarshal"
 
215
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"
221
216
>GClosureMarshal</a> marshaller,
222
217
                                                         <a
223
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
218
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
224
219
>GType</a> rettype,
225
220
                                                         ...);</pre>
226
221
<p>
227
222
Register a <a
228
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosureMarshal"
 
223
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"
229
224
><span class="type">GClosureMarshal</span></a> to be used for signal invocations,
230
225
giving its return type and a list of parameter types,
231
 
followed by <code class="literal">G_TYPE_INVALID</code>.
 
226
followed by <a
 
227
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID--CAPS"
 
228
><code class="literal">G_TYPE_INVALID</code></a>.
232
229
</p>
233
230
<p>
234
231
This function will not be needed once GLib includes libffi.</p>
235
232
<p>
236
 
 
237
233
</p>
238
234
<div class="variablelist"><table border="0">
239
235
<col align="left" valign="top">
246
242
<tr>
247
243
<td><p><span class="term"><em class="parameter"><code>rettype</code></em> :</span></p></td>
248
244
<td> a GType for the return type of the function
249
 
@:... The parameter <span class="type">GTypes</span>, followed by <code class="literal">G_TYPE_INVALID</code>
 
245
@:... The parameter <span class="type">GTypes</span>, followed by <a
 
246
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-INVALID--CAPS"
 
247
><code class="literal">G_TYPE_INVALID</code></a>
250
248
</td>
251
249
</tr>
252
250
<tr>
253
251
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
254
252
<td>
255
 
 
256
 
 
257
253
</td>
258
254
</tr>
259
255
</tbody>
264
260
<a name="dbus-g-object-register-marshaller-array"></a><h3>dbus_g_object_register_marshaller_array ()</h3>
265
261
<pre class="programlisting">void                dbus_g_object_register_marshaller_array
266
262
                                                        (<a
267
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosureMarshal"
 
263
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"
268
264
>GClosureMarshal</a> marshaller,
269
265
                                                         <a
270
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
266
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
271
267
>GType</a> rettype,
272
268
                                                         <a
273
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
 
269
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
274
270
>guint</a> n_types,
275
271
                                                         const <a
276
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
272
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
277
273
>GType</a> *types);</pre>
278
274
<p>
279
275
Register a <a
280
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosureMarshal"
 
276
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"
281
277
><span class="type">GClosureMarshal</span></a> to be used for signal invocations.
282
278
<em class="parameter"><code>see_also</code></em> <a class="link" href="dbus-glib-DBus-GObject-related-functions.html#dbus-g-object-register-marshaller" title="dbus_g_object_register_marshaller ()"><span class="type">dbus_g_object_register_marshaller</span></a></p>
283
279
<p>
284
 
 
285
280
</p>
286
281
<div class="variablelist"><table border="0">
287
282
<col align="left" valign="top">
289
284
<tr>
290
285
<td><p><span class="term"><em class="parameter"><code>marshaller</code></em> :</span></p></td>
291
286
<td> a <a
292
 
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosureMarshal"
 
287
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosureMarshal"
293
288
><span class="type">GClosureMarshal</span></a> to be used for invocation
294
289
</td>
295
290
</tr>
296
291
<tr>
297
292
<td><p><span class="term"><em class="parameter"><code>rettype</code></em> :</span></p></td>
298
293
<td> a <a
299
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
 
294
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
300
295
><span class="type">GType</span></a> for the return type of the function
301
296
</td>
302
297
</tr>
316
311
</div>
317
312
<div class="refsect1" lang="en">
318
313
<a name="dbus-glib-DBus-GObject-related-functions.see-also"></a><h2>See Also</h2>
319
 
<a
320
 
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
321
 
><span class="type">GObject</span></a>
 
314
#GObject
322
315
</div>
323
316
</div>
324
317
<div class="footer">
325
318
<hr>
326
 
          Generated by GTK-Doc V1.10</div>
 
319
          Generated by GTK-Doc V1.11</div>
327
320
</body>
328
321
</html>