8
8
<link rel="up" href="api-reference.html" title="API Reference">
9
9
<link rel="prev" href="bonobo-activation-Query-and-Activation.html" title="Query and Activation">
10
10
<link rel="next" href="bonobo-activation-Registration.html" title="Registration">
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="tutorial.html" title="Bonobo Activation tutorial">
14
14
<link rel="chapter" href="configuring.html" title="Configuring Bonobo Activation">
28
28
<th width="100%" align="center">Bonobo Activation API Reference Manual</th>
29
29
<td><a accesskey="n" href="bonobo-activation-Registration.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
31
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2756434" class="shortcut">Top</a>
31
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3114846" class="shortcut">Top</a>
33
<a href="#id2756705" class="shortcut">Description</a></nobr></td></tr>
33
<a href="#id3115116" class="shortcut">Description</a></nobr></td></tr>
35
35
<div class="refentry" lang="en">
36
36
<a name="bonobo-activation-Utilities"></a><div class="titlepage"></div>
37
37
<div class="refnamediv"><table width="100%"><tr>
40
<a name="id2756434"></a><span class="refentrytitle">Utilities</span>
40
<a name="id3114846"></a><span class="refentrytitle">Utilities</span>
42
42
<p>Utilities — Random misc utilities to manipulate Bonobo_ServerInfo structures.</p>
50
50
#include <bonobo-activation/bonobo-activation.h>
53
enum <a href="bonobo-activation-Utilities.html#Bonobo-ActivationPropertyType">Bonobo_ActivationPropertyType</a>;
54
Bonobo_ActivationProperty* <a href="bonobo-activation-Utilities.html#bonobo-server-info-prop-find">bonobo_server_info_prop_find</a>
55
(Bonobo_ServerInfo *server,
56
const char *prop_name);
57
<a href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID">Bonobo_ActivationID</a> <a href="bonobo-activation-Utilities.html#bonobo-activation-info-stringify">bonobo_activation_info_stringify</a>
58
(const BonoboActivationInfo *actinfo);
53
enum <a href="bonobo-activation-Utilities.html#Bonobo-ActivationPropertyType">Bonobo_ActivationPropertyType</a>;
54
Bonobo_ActivationProperty* <a href="bonobo-activation-Utilities.html#bonobo-server-info-prop-find">bonobo_server_info_prop_find</a> (Bonobo_ServerInfo *server,
55
const char *prop_name);
56
<a href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID">Bonobo_ActivationID</a> <a href="bonobo-activation-Utilities.html#bonobo-activation-info-stringify">bonobo_activation_info_stringify</a> (const BonoboActivationInfo *actinfo);
59
57
BonoboActivationInfo* <a href="bonobo-activation-Utilities.html#bonobo-activation-servinfo-to-actinfo">bonobo_activation_servinfo_to_actinfo</a>
60
(const Bonobo_ServerInfo *servinfo);
61
BonoboActivationInfo* <a href="bonobo-activation-Utilities.html#bonobo-activation-id-parse">bonobo_activation_id_parse</a>
62
(const CORBA_char *actid);
63
BonoboActivationInfo* <a href="bonobo-activation-Utilities.html#bonobo-activation-info-new">bonobo_activation_info_new</a>
65
void <a href="bonobo-activation-Utilities.html#bonobo-activation-info-free">bonobo_activation_info_free</a> (BonoboActivationInfo *actinfo);
66
const char* <a href="bonobo-activation-Utilities.html#bonobo-server-info-prop-lookup">bonobo_server_info_prop_lookup</a> (Bonobo_ServerInfo *server,
67
const char *prop_name,
58
(const Bonobo_ServerInfo *servinfo);
59
BonoboActivationInfo* <a href="bonobo-activation-Utilities.html#bonobo-activation-id-parse">bonobo_activation_id_parse</a> (const CORBA_char *actid);
60
BonoboActivationInfo* <a href="bonobo-activation-Utilities.html#bonobo-activation-info-new">bonobo_activation_info_new</a> (void);
61
void <a href="bonobo-activation-Utilities.html#bonobo-activation-info-free">bonobo_activation_info_free</a> (BonoboActivationInfo *actinfo);
62
const char* <a href="bonobo-activation-Utilities.html#bonobo-server-info-prop-lookup">bonobo_server_info_prop_lookup</a> (Bonobo_ServerInfo *server,
63
const char *prop_name,
69
65
href="../glib/glib-Singly-Linked-Lists.html#GSList"
70
66
>GSList</a> *i18n_languages);
71
typedef <a href="bonobo-activation-Utilities.html#Bonobo-ServerInfoList">Bonobo_ServerInfoList</a>;
72
Bonobo_ServerInfo* <a href="bonobo-activation-Utilities.html#bonobo-activation-get-default-component-for-mime-type">bonobo_activation_get_default_component_for_mime_type</a>
73
(const char *mime_type);
67
typedef <a href="bonobo-activation-Utilities.html#Bonobo-ServerInfoList">Bonobo_ServerInfoList</a>;
68
Bonobo_ServerInfo* <a href="bonobo-activation-Utilities.html#bonobo-activation-get-default-component-for-mime-type">bonobo_activation_get_default_component_for_mime_type</a>
69
(const char *mime_type);
75
71
href="../glib/glib-Doubly-Linked-Lists.html#GList"
76
>GList</a>* <a href="bonobo-activation-Utilities.html#bonobo-activation-get-all-components-for-mime-type">bonobo_activation_get_all_components_for_mime_type</a>
77
(const char *mime_type);
72
>GList</a>* <a href="bonobo-activation-Utilities.html#bonobo-activation-get-all-components-for-mime-type">bonobo_activation_get_all_components_for_mime_type</a>
73
(const char *mime_type);
81
77
<div class="refsect1" lang="en">
82
<a name="id2756705"></a><h2>Description</h2>
78
<a name="id3115116"></a><h2>Description</h2>
87
83
<div class="refsect1" lang="en">
88
<a name="id2756720"></a><h2>Details</h2>
84
<a name="id3115130"></a><h2>Details</h2>
89
85
<div class="refsect2" lang="en">
90
<a name="id2756730"></a><h3>
86
<a name="id3115140"></a><h3>
91
87
<a name="Bonobo-ActivationPropertyType"></a>enum Bonobo_ActivationPropertyType</h3>
92
<a class="indexterm" name="id2756743"></a><pre class="programlisting">typedef enum {
88
<a class="indexterm" name="id3115153"></a><pre class="programlisting">typedef enum {
93
89
Bonobo_ACTIVATION_P_STRING,
94
90
Bonobo_ACTIVATION_P_NUMBER,
95
91
Bonobo_ACTIVATION_P_BOOLEAN,
104
100
<div class="refsect2" lang="en">
105
<a name="id2756761"></a><h3>
101
<a name="id3115171"></a><h3>
106
102
<a name="bonobo-server-info-prop-find"></a>bonobo_server_info_prop_find ()</h3>
107
<a class="indexterm" name="id2756774"></a><pre class="programlisting">Bonobo_ActivationProperty* bonobo_server_info_prop_find
108
(Bonobo_ServerInfo *server,
109
const char *prop_name);</pre>
103
<a class="indexterm" name="id3115184"></a><pre class="programlisting">Bonobo_ActivationProperty* bonobo_server_info_prop_find (Bonobo_ServerInfo *server,
104
const char *prop_name);</pre>
111
106
Tries to find a server with the given property. Returns
112
107
NULL if not found.</p>
138
133
<div class="refsect2" lang="en">
139
<a name="id2756871"></a><h3>
134
<a name="id3115281"></a><h3>
140
135
<a name="bonobo-activation-info-stringify"></a>bonobo_activation_info_stringify ()</h3>
141
<a class="indexterm" name="id2756887"></a><pre class="programlisting"><a href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID">Bonobo_ActivationID</a> bonobo_activation_info_stringify
142
(const BonoboActivationInfo *actinfo);</pre>
136
<a class="indexterm" name="id3115297"></a><pre class="programlisting"><a href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID">Bonobo_ActivationID</a> bonobo_activation_info_stringify (const BonoboActivationInfo *actinfo);</pre>
143
137
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
144
138
<h3 class="title">Warning</h3>
145
139
<p><code class="literal">bonobo_activation_info_stringify</code> is deprecated and should not be used in newly-written code.</p>
171
165
<div class="refsect2" lang="en">
172
<a name="id2756997"></a><h3>
166
<a name="id3115406"></a><h3>
173
167
<a name="bonobo-activation-servinfo-to-actinfo"></a>bonobo_activation_servinfo_to_actinfo ()</h3>
174
<a class="indexterm" name="id2757013"></a><pre class="programlisting">BonoboActivationInfo* bonobo_activation_servinfo_to_actinfo
175
(const Bonobo_ServerInfo *servinfo);</pre>
168
<a class="indexterm" name="id3115422"></a><pre class="programlisting">BonoboActivationInfo* bonobo_activation_servinfo_to_actinfo
169
(const Bonobo_ServerInfo *servinfo);</pre>
176
170
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
177
171
<h3 class="title">Warning</h3>
178
172
<p><code class="literal">bonobo_activation_servinfo_to_actinfo</code> is deprecated and should not be used in newly-written code.</p>
204
198
<div class="refsect2" lang="en">
205
<a name="id2757134"></a><h3>
199
<a name="id3115544"></a><h3>
206
200
<a name="bonobo-activation-id-parse"></a>bonobo_activation_id_parse ()</h3>
207
<a class="indexterm" name="id2757151"></a><pre class="programlisting">BonoboActivationInfo* bonobo_activation_id_parse
208
(const CORBA_char *actid);</pre>
201
<a class="indexterm" name="id3115560"></a><pre class="programlisting">BonoboActivationInfo* bonobo_activation_id_parse (const CORBA_char *actid);</pre>
209
202
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
210
203
<h3 class="title">Warning</h3>
211
204
<p><code class="literal">bonobo_activation_id_parse</code> is deprecated and should not be used in newly-written code.</p>
237
230
<div class="refsect2" lang="en">
238
<a name="id2757260"></a><h3>
231
<a name="id3115669"></a><h3>
239
232
<a name="bonobo-activation-info-new"></a>bonobo_activation_info_new ()</h3>
240
<a class="indexterm" name="id2757276"></a><pre class="programlisting">BonoboActivationInfo* bonobo_activation_info_new
233
<a class="indexterm" name="id3115685"></a><pre class="programlisting">BonoboActivationInfo* bonobo_activation_info_new (void);</pre>
242
234
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
243
235
<h3 class="title">Warning</h3>
244
236
<p><code class="literal">bonobo_activation_info_new</code> is deprecated and should not be used in newly-written code.</p>
262
254
<div class="refsect2" lang="en">
263
<a name="id2757355"></a><h3>
255
<a name="id3115763"></a><h3>
264
256
<a name="bonobo-activation-info-free"></a>bonobo_activation_info_free ()</h3>
265
<a class="indexterm" name="id2757370"></a><pre class="programlisting">void bonobo_activation_info_free (BonoboActivationInfo *actinfo);</pre>
257
<a class="indexterm" name="id3115778"></a><pre class="programlisting">void bonobo_activation_info_free (BonoboActivationInfo *actinfo);</pre>
266
258
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
267
259
<h3 class="title">Warning</h3>
268
260
<p><code class="literal">bonobo_activation_info_free</code> is deprecated and should not be used in newly-written code.</p>
285
277
<div class="refsect2" lang="en">
286
<a name="id2757450"></a><h3>
278
<a name="id3115858"></a><h3>
287
279
<a name="bonobo-server-info-prop-lookup"></a>bonobo_server_info_prop_lookup ()</h3>
288
<a class="indexterm" name="id2757464"></a><pre class="programlisting">const char* bonobo_server_info_prop_lookup (Bonobo_ServerInfo *server,
289
const char *prop_name,
280
<a class="indexterm" name="id3115872"></a><pre class="programlisting">const char* bonobo_server_info_prop_lookup (Bonobo_ServerInfo *server,
281
const char *prop_name,
291
283
href="../glib/glib-Singly-Linked-Lists.html#GSList"
292
284
>GSList</a> *i18n_languages);</pre>
335
327
<div class="refsect2" lang="en">
336
<a name="id2757597"></a><h3>
328
<a name="id3116006"></a><h3>
337
329
<a name="bonobo-activation-get-default-component-for-mime-type"></a>bonobo_activation_get_default_component_for_mime_type ()</h3>
338
<a class="indexterm" name="id2757613"></a><pre class="programlisting">Bonobo_ServerInfo* bonobo_activation_get_default_component_for_mime_type
339
(const char *mime_type);</pre>
330
<a class="indexterm" name="id3116022"></a><pre class="programlisting">Bonobo_ServerInfo* bonobo_activation_get_default_component_for_mime_type
331
(const char *mime_type);</pre>
341
333
Query the MIME database for the default Bonobo component to be activated to
342
334
view files of MIME type <em class="parameter"><code>mime_type</code></em>.</p>
355
<p class="since">Since 2.16.0
367
359
<div class="refsect2" lang="en">
368
<a name="id2757698"></a><h3>
360
<a name="id3116110"></a><h3>
369
361
<a name="bonobo-activation-get-all-components-for-mime-type"></a>bonobo_activation_get_all_components_for_mime_type ()</h3>
370
<a class="indexterm" name="id2757715"></a><pre class="programlisting"><a
362
<a class="indexterm" name="id3116126"></a><pre class="programlisting"><a
371
363
href="../glib/glib-Doubly-Linked-Lists.html#GList"
372
>GList</a>* bonobo_activation_get_all_components_for_mime_type
373
(const char *mime_type);</pre>
364
>GList</a>* bonobo_activation_get_all_components_for_mime_type
365
(const char *mime_type);</pre>
375
367
Return an alphabetically sorted list of <span class="type">Bonobo_ServerInfo</span>
376
368
data structures representing all Bonobo components registered