← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/libbonobo/jaunty

« back to all changes in this revision

Viewing changes to doc/api/html/libbonobo-bonobo-application.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2009-03-06 18:53:16 UTC
  • mfrom: (1.1.25 upstream) (3.1.3 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090306185316-uf09r30g7cvf67xi
Tags: 2.24.1-1
* New upstream bugfix release.
* debian/control.in:
  + Build depend on GLib >= 2.14.0.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/api/html/libbonobo-bonobo-application.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>bonobo-application</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.2">
7
7
<link rel="home" href="index.html" title="Libbonobo Reference Manual">
8
8
<link rel="up" href="general.html" title="General">
9
9
<link rel="prev" href="libbonobo-bonobo-exception.html" title="bonobo-exception">
48
48
<pre class="synopsis">
49
49
void                (<a class="link" href="libbonobo-bonobo-application.html#BonoboAppHookFunc" title="BonoboAppHookFunc ()">*BonoboAppHookFunc</a>)                (BonoboApplication *app,
50
50
                                                         <a
51
 
href="../glib/glib-Basic-Types.html#gpointer"
 
51
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
52
52
>gpointer</a> data);
53
53
BonoboApplication*  <a class="link" href="libbonobo-bonobo-application.html#bonobo-application-new" title="bonobo_application_new ()">bonobo_application_new</a>              (const char *name);
54
54
void                <a class="link" href="libbonobo-bonobo-application.html#bonobo-application-register-message" title="bonobo_application_register_message ()">bonobo_application_register_message</a> (BonoboApplication *app,
55
55
                                                         const <a
56
 
href="../glib/glib-Basic-Types.html#gchar"
 
56
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
57
57
>gchar</a> *name,
58
58
                                                         const <a
59
 
href="../glib/glib-Basic-Types.html#gchar"
 
59
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
60
60
>gchar</a> *description,
61
61
                                                         <a
62
 
href="../gobject/gobject-Closures.html#GClosure"
 
62
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
63
63
>GClosure</a> *opt_closure,
64
64
                                                         <a
65
 
href="../gobject/gobject-Type-Information.html#GType"
 
65
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
66
66
>GType</a> return_type,
67
67
                                                         <a
68
 
href="../gobject/gobject-Type-Information.html#GType"
 
68
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
69
69
>GType</a> first_arg_type,
70
70
                                                         ...);
71
71
void                <a class="link" href="libbonobo-bonobo-application.html#bonobo-application-register-message-v" title="bonobo_application_register_message_v ()">bonobo_application_register_message_v</a>
72
72
                                                        (BonoboApplication *app,
73
73
                                                         const <a
74
 
href="../glib/glib-Basic-Types.html#gchar"
 
74
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
75
75
>gchar</a> *name,
76
76
                                                         const <a
77
 
href="../glib/glib-Basic-Types.html#gchar"
 
77
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
78
78
>gchar</a> *description,
79
79
                                                         <a
80
 
href="../gobject/gobject-Closures.html#GClosure"
 
80
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
81
81
>GClosure</a> *opt_closure,
82
82
                                                         <a
83
 
href="../gobject/gobject-Type-Information.html#GType"
 
83
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
84
84
>GType</a> return_type,
85
85
                                                         <a
86
 
href="../gobject/gobject-Type-Information.html#GType"
 
86
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
87
87
>GType</a> const arg_types[]);
88
88
void                <a class="link" href="libbonobo-bonobo-application.html#bonobo-application-register-message-va" title="bonobo_application_register_message_va ()">bonobo_application_register_message_va</a>
89
89
                                                        (BonoboApplication *app,
90
90
                                                         const <a
91
 
href="../glib/glib-Basic-Types.html#gchar"
 
91
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
92
92
>gchar</a> *name,
93
93
                                                         const <a
94
 
href="../glib/glib-Basic-Types.html#gchar"
 
94
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
95
95
>gchar</a> *description,
96
96
                                                         <a
97
 
href="../gobject/gobject-Closures.html#GClosure"
 
97
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
98
98
>GClosure</a> *opt_closure,
99
99
                                                         <a
100
 
href="../gobject/gobject-Type-Information.html#GType"
 
100
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
101
101
>GType</a> return_type,
102
102
                                                         <a
103
 
href="../gobject/gobject-Type-Information.html#GType"
 
103
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
104
104
>GType</a> first_arg_type,
105
105
                                                         va_list var_args);
106
106
<a
107
 
href="../glib/glib-Basic-Types.html#gint"
 
107
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
108
108
>gint</a>                <a class="link" href="libbonobo-bonobo-application.html#bonobo-application-new-instance" title="bonobo_application_new_instance ()">bonobo_application_new_instance</a>     (BonoboApplication *app,
109
109
                                                         <a
110
 
href="../glib/glib-Basic-Types.html#gint"
 
110
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
111
111
>gint</a> argc,
112
112
                                                         <a
113
 
href="../glib/glib-Basic-Types.html#gchar"
 
113
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
114
114
>gchar</a> *argv[]);
115
115
<a
116
 
href="../glib/glib-Basic-Types.html#gchar"
 
116
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
117
117
>gchar</a> *             <a class="link" href="libbonobo-bonobo-application.html#bonobo-application-create-serverinfo" title="bonobo_application_create_serverinfo ()">bonobo_application_create_serverinfo</a>
118
118
                                                        (BonoboApplication *app,
119
119
                                                         <a
120
 
href="../glib/glib-Basic-Types.html#gchar"
 
120
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
121
121
>gchar</a> const *envp[]);
122
122
<a
123
 
href="/opt/gnome2/share/gtk-doc/html/bonobo-activation/bonobo-activation-Registration.html#Bonobo-RegistrationResult"
 
123
href="/usr/share/gtk-doc/html/bonobo-activation/bonobo-activation-Registration.html#Bonobo-RegistrationResult"
124
124
>Bonobo_RegistrationResult</a>  <a class="link" href="libbonobo-bonobo-application.html#bonobo-application-register-unique" title="bonobo_application_register_unique ()">bonobo_application_register_unique</a>
125
125
                                                        (BonoboApplication *app,
126
126
                                                         <a
127
 
href="../glib/glib-Basic-Types.html#gchar"
 
127
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
128
128
>gchar</a> const *serverinfo,
129
129
                                                         BonoboAppClient **client);
130
130
void                <a class="link" href="libbonobo-bonobo-application.html#bonobo-application-add-hook" title="bonobo_application_add_hook ()">bonobo_application_add_hook</a>         (<a class="link" href="libbonobo-bonobo-application.html#BonoboAppHookFunc" title="BonoboAppHookFunc ()">BonoboAppHookFunc</a> func,
131
131
                                                         <a
132
 
href="../glib/glib-Basic-Types.html#gpointer"
 
132
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
133
133
>gpointer</a> data);
134
134
void                <a class="link" href="libbonobo-bonobo-application.html#bonobo-application-remove-hook" title="bonobo_application_remove_hook ()">bonobo_application_remove_hook</a>      (<a class="link" href="libbonobo-bonobo-application.html#BonoboAppHookFunc" title="BonoboAppHookFunc ()">BonoboAppHookFunc</a> func,
135
135
                                                         <a
136
 
href="../glib/glib-Basic-Types.html#gpointer"
 
136
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
137
137
>gpointer</a> data);
138
138
</pre>
139
139
</div>
148
148
<a name="BonoboAppHookFunc"></a><h3>BonoboAppHookFunc ()</h3>
149
149
<pre class="programlisting">void                (*BonoboAppHookFunc)                (BonoboApplication *app,
150
150
                                                         <a
151
 
href="../glib/glib-Basic-Types.html#gpointer"
 
151
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
152
152
>gpointer</a> data);</pre>
153
153
<p>
154
154
</p>
197
197
<a name="bonobo-application-register-message"></a><h3>bonobo_application_register_message ()</h3>
198
198
<pre class="programlisting">void                bonobo_application_register_message (BonoboApplication *app,
199
199
                                                         const <a
200
 
href="../glib/glib-Basic-Types.html#gchar"
 
200
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
201
201
>gchar</a> *name,
202
202
                                                         const <a
203
 
href="../glib/glib-Basic-Types.html#gchar"
 
203
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
204
204
>gchar</a> *description,
205
205
                                                         <a
206
 
href="../gobject/gobject-Closures.html#GClosure"
 
206
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
207
207
>GClosure</a> *opt_closure,
208
208
                                                         <a
209
 
href="../gobject/gobject-Type-Information.html#GType"
 
209
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
210
210
>GType</a> return_type,
211
211
                                                         <a
212
 
href="../gobject/gobject-Type-Information.html#GType"
 
212
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
213
213
>GType</a> first_arg_type,
214
214
                                                         ...);</pre>
215
215
<p>
216
216
Registers a new message type that the application supports.</p>
217
217
<p>
218
 
When <em class="parameter"><code>opt_closure</code></em> is provided (and is non-<code class="literal">NULL</code>) it takes care of calling the
 
218
When <em class="parameter"><code>opt_closure</code></em> is provided (and is non-<a
 
219
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 
220
><code class="literal">NULL</code></a>) it takes care of calling the
219
221
callback function with the same arguments as registered for the message.  On
220
 
the other hand if <em class="parameter"><code>opt_closure</code></em> is <code class="literal">NULL</code>, the function arguments are provided in
 
222
the other hand if <em class="parameter"><code>opt_closure</code></em> is <a
 
223
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 
224
><code class="literal">NULL</code></a>, the function arguments are provided in
221
225
a <a
222
 
href="../gobject/gobject-Value-arrays.html#GValueArray"
 
226
href="http://library.gnome.org/devel/gobject/unstable/gobject-Value-arrays.html#GValueArray"
223
227
><span class="type">GValueArray</span></a>.  This enables defining functions that accept variable number of
224
228
arguments, but is perhaps a little more tedious to implement.
225
229
</p>
226
230
<p>
227
231
</p>
228
232
<div class="example">
229
 
<a name="id2744963"></a><p class="title"><b>Example 5. Function with a closure</b></p>
 
233
<a name="id2985214"></a><p class="title"><b>Example 5. Function with a closure</b></p>
230
234
<div class="example-contents"><pre class="programlisting">
231
235
static void
232
236
message_open_url_cb (BonoboApplication *app, const char *url, gboolean new_win)
246
250
<p>
247
251
</p>
248
252
<div class="example">
249
 
<a name="id2744988"></a><p class="title"><b>Example 6. Function accepting variable number of arguments</b></p>
 
253
<a name="id2985239"></a><p class="title"><b>Example 6. Function accepting variable number of arguments</b></p>
250
254
<div class="example-contents"><pre class="programlisting">
251
255
static GValue *
252
256
message_open_url_cb (BonoboApplication *app, const char *message, GValueArray *args)
304
308
<tr>
305
309
<td><p><span class="term"><em class="parameter"><code>opt_closure</code></em> :</span></p></td>
306
310
<td> a <a
307
 
href="../gobject/gobject-Closures.html#GClosure"
 
311
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
308
312
><span class="type">GClosure</span></a> that will be called for this message, or
309
 
<code class="literal">NULL</code>; Function takes ownership of this closure.
 
313
<a
 
314
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 
315
><code class="literal">NULL</code></a>; Function takes ownership of this closure.
310
316
</td>
311
317
</tr>
312
318
<tr>
313
319
<td><p><span class="term"><em class="parameter"><code>return_type</code></em> :</span></p></td>
314
320
<td> Message return <a
315
 
href="../gobject/gobject-Type-Information.html#GType"
 
321
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
316
322
><span class="type">GType</span></a>.
317
323
</td>
318
324
</tr>
319
325
<tr>
320
326
<td><p><span class="term"><em class="parameter"><code>first_arg_type</code></em> :</span></p></td>
321
327
<td> <a
322
 
href="../gobject/gobject-Type-Information.html#GType"
323
 
><span class="type">GType</span></a> of first argument of message, or <code class="literal">G_TYPE_NONE</code>.
 
328
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
 
329
><span class="type">GType</span></a> of first argument of message, or <a
 
330
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-NONE--CAPS"
 
331
><code class="literal">G_TYPE_NONE</code></a>.
324
332
</td>
325
333
</tr>
326
334
<tr>
327
335
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
328
 
<td> <code class="literal">G_TYPE_NONE</code> -terminated list of argument <a
329
 
href="../gobject/gobject-Type-Information.html#GType"
 
336
<td> <a
 
337
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-NONE--CAPS"
 
338
><code class="literal">G_TYPE_NONE</code></a> -terminated list of argument <a
 
339
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
330
340
><span class="type">GType</span></a>'s
331
341
</td>
332
342
</tr>
339
349
<pre class="programlisting">void                bonobo_application_register_message_v
340
350
                                                        (BonoboApplication *app,
341
351
                                                         const <a
342
 
href="../glib/glib-Basic-Types.html#gchar"
 
352
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
343
353
>gchar</a> *name,
344
354
                                                         const <a
345
 
href="../glib/glib-Basic-Types.html#gchar"
 
355
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
346
356
>gchar</a> *description,
347
357
                                                         <a
348
 
href="../gobject/gobject-Closures.html#GClosure"
 
358
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
349
359
>GClosure</a> *opt_closure,
350
360
                                                         <a
351
 
href="../gobject/gobject-Type-Information.html#GType"
 
361
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
352
362
>GType</a> return_type,
353
363
                                                         <a
354
 
href="../gobject/gobject-Type-Information.html#GType"
 
364
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
355
365
>GType</a> const arg_types[]);</pre>
356
366
<p>
357
367
See <a class="link" href="libbonobo-bonobo-application.html#bonobo-application-register-message" title="bonobo_application_register_message ()"><code class="function">bonobo_application_register_message()</code></a>.</p>
378
388
<tr>
379
389
<td><p><span class="term"><em class="parameter"><code>opt_closure</code></em> :</span></p></td>
380
390
<td> a <a
381
 
href="../gobject/gobject-Closures.html#GClosure"
382
 
><span class="type">GClosure</span></a> that will be called for this message, or <code class="literal">NULL</code>;
 
391
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
 
392
><span class="type">GClosure</span></a> that will be called for this message, or <a
 
393
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 
394
><code class="literal">NULL</code></a>;
383
395
Function takes ownership of this closure.
384
396
</td>
385
397
</tr>
386
398
<tr>
387
399
<td><p><span class="term"><em class="parameter"><code>return_type</code></em> :</span></p></td>
388
400
<td> Message return <a
389
 
href="../gobject/gobject-Type-Information.html#GType"
 
401
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
390
402
><span class="type">GType</span></a>.
391
403
</td>
392
404
</tr>
393
405
<tr>
394
406
<td><p><span class="term"><em class="parameter"><code>arg_types</code></em> :</span></p></td>
395
 
<td> <code class="literal">G_TYPE_NONE</code> -terminated vector of argument <a
396
 
href="../gobject/gobject-Type-Information.html#GType"
 
407
<td> <a
 
408
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-NONE--CAPS"
 
409
><code class="literal">G_TYPE_NONE</code></a> -terminated vector of argument <a
 
410
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
397
411
><span class="type">GType</span></a>'s
398
412
</td>
399
413
</tr>
406
420
<pre class="programlisting">void                bonobo_application_register_message_va
407
421
                                                        (BonoboApplication *app,
408
422
                                                         const <a
409
 
href="../glib/glib-Basic-Types.html#gchar"
 
423
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
410
424
>gchar</a> *name,
411
425
                                                         const <a
412
 
href="../glib/glib-Basic-Types.html#gchar"
 
426
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
413
427
>gchar</a> *description,
414
428
                                                         <a
415
 
href="../gobject/gobject-Closures.html#GClosure"
 
429
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
416
430
>GClosure</a> *opt_closure,
417
431
                                                         <a
418
 
href="../gobject/gobject-Type-Information.html#GType"
 
432
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
419
433
>GType</a> return_type,
420
434
                                                         <a
421
 
href="../gobject/gobject-Type-Information.html#GType"
 
435
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
422
436
>GType</a> first_arg_type,
423
437
                                                         va_list var_args);</pre>
424
438
<p>
446
460
<tr>
447
461
<td><p><span class="term"><em class="parameter"><code>opt_closure</code></em> :</span></p></td>
448
462
<td> a <a
449
 
href="../gobject/gobject-Closures.html#GClosure"
 
463
href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#GClosure"
450
464
><span class="type">GClosure</span></a> that will be called for this message, or
451
 
<code class="literal">NULL</code>; Function takes ownership of this closure.
 
465
<a
 
466
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 
467
><code class="literal">NULL</code></a>; Function takes ownership of this closure.
452
468
</td>
453
469
</tr>
454
470
<tr>
455
471
<td><p><span class="term"><em class="parameter"><code>return_type</code></em> :</span></p></td>
456
472
<td> Message return <a
457
 
href="../gobject/gobject-Type-Information.html#GType"
 
473
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
458
474
><span class="type">GType</span></a>.
459
475
</td>
460
476
</tr>
461
477
<tr>
462
478
<td><p><span class="term"><em class="parameter"><code>first_arg_type</code></em> :</span></p></td>
463
479
<td> <a
464
 
href="../gobject/gobject-Type-Information.html#GType"
465
 
><span class="type">GType</span></a> of first argument of message, or <code class="literal">G_TYPE_NONE</code>
 
480
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
 
481
><span class="type">GType</span></a> of first argument of message, or <a
 
482
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-NONE--CAPS"
 
483
><code class="literal">G_TYPE_NONE</code></a>
466
484
</td>
467
485
</tr>
468
486
<tr>
469
487
<td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td>
470
 
<td> <code class="literal">G_TYPE_NONE</code> -terminated valist of argument <a
471
 
href="../gobject/gobject-Type-Information.html#GType"
 
488
<td> <a
 
489
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-TYPE-NONE--CAPS"
 
490
><code class="literal">G_TYPE_NONE</code></a> -terminated valist of argument <a
 
491
href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"
472
492
><span class="type">GType</span></a>'s
473
493
</td>
474
494
</tr>
479
499
<div class="refsect2" lang="en">
480
500
<a name="bonobo-application-new-instance"></a><h3>bonobo_application_new_instance ()</h3>
481
501
<pre class="programlisting"><a
482
 
href="../glib/glib-Basic-Types.html#gint"
 
502
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
483
503
>gint</a>                bonobo_application_new_instance     (BonoboApplication *app,
484
504
                                                         <a
485
 
href="../glib/glib-Basic-Types.html#gint"
 
505
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
486
506
>gint</a> argc,
487
507
                                                         <a
488
 
href="../glib/glib-Basic-Types.html#gchar"
 
508
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
489
509
>gchar</a> *argv[]);</pre>
490
510
<p>
491
511
Emit the "new-instance" signal of the <span class="type">BonoboApplication</span> with the
522
542
<div class="refsect2" lang="en">
523
543
<a name="bonobo-application-create-serverinfo"></a><h3>bonobo_application_create_serverinfo ()</h3>
524
544
<pre class="programlisting"><a
525
 
href="../glib/glib-Basic-Types.html#gchar"
 
545
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
526
546
>gchar</a> *             bonobo_application_create_serverinfo
527
547
                                                        (BonoboApplication *app,
528
548
                                                         <a
529
 
href="../glib/glib-Basic-Types.html#gchar"
 
549
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
530
550
>gchar</a> const *envp[]);</pre>
531
551
<p>
532
552
This utility function provides a simple way to contruct a valid
543
563
</tr>
544
564
<tr>
545
565
<td><p><span class="term"><em class="parameter"><code>envp</code></em> :</span></p></td>
546
 
<td> <code class="literal">NULL</code>-terminated string vector, containing the enviroment
 
566
<td> <a
 
567
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 
568
><code class="literal">NULL</code></a>-terminated string vector, containing the enviroment
547
569
variables we wish to include in the server description.
548
570
</td>
549
571
</tr>
550
572
<tr>
551
573
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
552
574
<td> a newly allocated string; caller must <a
553
 
href="../glib/glib-Memory-Allocation.html#g-free"
 
575
href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
554
576
><code class="function">g_free()</code></a> it.
555
577
</td>
556
578
</tr>
561
583
<div class="refsect2" lang="en">
562
584
<a name="bonobo-application-register-unique"></a><h3>bonobo_application_register_unique ()</h3>
563
585
<pre class="programlisting"><a
564
 
href="/opt/gnome2/share/gtk-doc/html/bonobo-activation/bonobo-activation-Registration.html#Bonobo-RegistrationResult"
 
586
href="/usr/share/gtk-doc/html/bonobo-activation/bonobo-activation-Registration.html#Bonobo-RegistrationResult"
565
587
>Bonobo_RegistrationResult</a>  bonobo_application_register_unique
566
588
                                                        (BonoboApplication *app,
567
589
                                                         <a
568
 
href="../glib/glib-Basic-Types.html#gchar"
 
590
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
569
591
>gchar</a> const *serverinfo,
570
592
                                                         BonoboAppClient **client);</pre>
571
593
<p>
580
602
application is already running, then the output variable
581
603
<em class="parameter"><code>client</code></em> will receive a newly created <span class="type">BonoboAppClient</span>
582
604
associated with the running application.  Otherwise, *<em class="parameter"><code>client</code></em> is
583
 
set to <code class="literal">NULL</code>.</p>
 
605
set to <a
 
606
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 
607
><code class="literal">NULL</code></a>.</p>
584
608
<p>
585
609
</p>
586
610
<div class="variablelist"><table border="0">
601
625
<tr>
602
626
<td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
603
627
<td> output parameter that will contain a client object, in
604
 
case another instance has already running, or <code class="literal">NULL</code> if we are the
 
628
case another instance has already running, or <a
 
629
href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 
630
><code class="literal">NULL</code></a> if we are the
605
631
first to register.
606
632
</td>
607
633
</tr>
622
648
<a name="bonobo-application-add-hook"></a><h3>bonobo_application_add_hook ()</h3>
623
649
<pre class="programlisting">void                bonobo_application_add_hook         (<a class="link" href="libbonobo-bonobo-application.html#BonoboAppHookFunc" title="BonoboAppHookFunc ()">BonoboAppHookFunc</a> func,
624
650
                                                         <a
625
 
href="../glib/glib-Basic-Types.html#gpointer"
 
651
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
626
652
>gpointer</a> data);</pre>
627
653
<p>
628
654
Add a hook function to be called whenever a new <span class="type">BonoboApplication</span>
650
676
<a name="bonobo-application-remove-hook"></a><h3>bonobo_application_remove_hook ()</h3>
651
677
<pre class="programlisting">void                bonobo_application_remove_hook      (<a class="link" href="libbonobo-bonobo-application.html#BonoboAppHookFunc" title="BonoboAppHookFunc ()">BonoboAppHookFunc</a> func,
652
678
                                                         <a
653
 
href="../glib/glib-Basic-Types.html#gpointer"
 
679
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
654
680
>gpointer</a> data);</pre>
655
681
<p>
656
682
Removes a hook function previously set with <a class="link" href="libbonobo-bonobo-application.html#bonobo-application-add-hook" title="bonobo_application_add_hook ()"><code class="function">bonobo_application_add_hook()</code></a>.</p>