← Back to branch summary

~ubuntu-branches/ubuntu/hardy/glib2.0/hardy-updates

« back to all changes in this revision

Viewing changes to docs/reference/gio/html/gio-Extension-Points.html

  • Committer: Bazaar Package Importer
  • Author(s): Jamie Strandboge
  • Date: 2009-03-12 16:46:11 UTC
  • mfrom: (67.1.7 hardy-proposed)
  • Revision ID: james.westby@ubuntu.com-20090312164611-31v55ts0v0j0u06k
Tags: 2.16.6-0ubuntu1.1
* SECURITY UPDATE: possible arbitrary code execution when processing large
  Base64 strings
  - debian/patches/91_CVE-2008-4316.patch: update glib/gbase64.c to properly
    verify the string length and set the length of the output buffer.
  - CVE-2008-4316

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gio/html/gio-Extension-Points.html
1
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
2
<html>
3
3
<head>
4
 
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>Extension Points</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
 
<link rel="start" href="index.html" title="GIO Reference Manual">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
 
7
<link rel="home" href="index.html" title="GIO Reference Manual">
8
8
<link rel="up" href="extending.html" title="Extending GIO">
9
9
<link rel="prev" href="GIOModule.html" title="GIOModule">
10
 
<link rel="next" href="migrating.html" title="Part&#160;III.&#160;Migrating to GIO">
11
 
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
 
10
<link rel="next" href="migrating.html" title="Part III. Migrating to GIO">
 
11
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
 
<link rel="part" href="pt01.html" title="Part&#160;I.&#160;GIO Overview">
 
13
<link rel="part" href="pt01.html" title="Part I. GIO Overview">
14
14
<link rel="chapter" href="ch01.html" title="Introduction">
15
15
<link rel="chapter" href="ch02.html" title="Compiling GIO applications">
16
16
<link rel="chapter" href="ch03.html" title="Running GIO applications">
17
17
<link rel="chapter" href="gio-extension-points.html" title="Extending GIO">
18
 
<link rel="part" href="pt02.html" title="Part&#160;II.&#160;API Reference">
 
18
<link rel="part" href="pt02.html" title="Part II. API Reference">
19
19
<link rel="chapter" href="file_ops.html" title="File Operations">
20
20
<link rel="chapter" href="file_mon.html" title="File System Monitoring">
21
21
<link rel="chapter" href="async.html" title="Asynchronous I/O">
25
25
<link rel="chapter" href="icons.html" title="Icons">
26
26
<link rel="chapter" href="utils.html" title="Utilities">
27
27
<link rel="chapter" href="extending.html" title="Extending GIO">
28
 
<link rel="part" href="migrating.html" title="Part&#160;III.&#160;Migrating to GIO">
 
28
<link rel="part" href="migrating.html" title="Part III. Migrating to GIO">
29
29
<link rel="chapter" href="ch14.html" title="Migrating from POSIX to GIO">
30
30
<link rel="chapter" href="ch15.html" title="Migrating from GnomeVFS to GIO">
31
31
<link rel="chapter" href="gio-hierarchy.html" title="Object Hierarchy">
40
40
<th width="100%" align="center">GIO Reference Manual</th>
41
41
<td><a accesskey="n" href="migrating.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
42
42
</tr>
43
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2768221" class="shortcut">Top</a>
44
 
                  &#160;|&#160;
45
 
                  <a href="#id2899846" class="shortcut">Description</a></nobr></td></tr>
 
43
<tr><td colspan="5" class="shortcuts"><nobr><a href="#gio-Extension-Points.synopsis" class="shortcut">Top</a>
 
44
                   | 
 
45
                  <a href="#gio-Extension-Points.description" class="shortcut">Description</a></nobr></td></tr>
46
46
</table>
47
47
<div class="refentry" lang="en">
48
48
<a name="gio-Extension-Points"></a><div class="titlepage"></div>
49
49
<div class="refnamediv"><table width="100%"><tr>
50
50
<td valign="top">
51
 
<h2>
52
 
<a name="id2768221"></a><span class="refentrytitle">Extension Points</span>
53
 
</h2>
54
 
<p>Extension Points &#8212; Extension Points</p>
 
51
<h2><span class="refentrytitle"><a name="gio-Extension-Points.top_of_page"></a>Extension Points</span></h2>
 
52
<p>Extension Points — Extension Points</p>
55
53
</td>
56
54
<td valign="top" align="right"></td>
57
55
</tr></table></div>
58
56
<div class="refsynopsisdiv">
59
 
<h2>Synopsis</h2>
 
57
<a name="gio-Extension-Points.synopsis"></a><h2>Synopsis</h2>
60
58
<pre class="synopsis">
61
59
 
62
60
#include &lt;gio.h&gt;
63
61
 
64
 
 
65
 
                    <a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a>;
66
 
                    <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a>;
67
 
const char*         <a class="link" href="gio-Extension-Points.html#g-io-extension-get-name">g_io_extension_get_name</a>             (<a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a> *extension);
 
62
                    <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a>;
 
63
                    <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a>;
 
64
const char*         <a class="link" href="gio-Extension-Points.html#g-io-extension-get-name" title="g_io_extension_get_name ()">g_io_extension_get_name</a>             (<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *extension);
68
65
<a
69
66
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
70
 
>gint</a>                <a class="link" href="gio-Extension-Points.html#g-io-extension-get-priority">g_io_extension_get_priority</a>         (<a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a> *extension);
 
67
>gint</a>                <a class="link" href="gio-Extension-Points.html#g-io-extension-get-priority" title="g_io_extension_get_priority ()">g_io_extension_get_priority</a>         (<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *extension);
71
68
<a
72
69
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
73
 
>GType</a>               <a class="link" href="gio-Extension-Points.html#g-io-extension-get-type">g_io_extension_get_type</a>             (<a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a> *extension);
74
 
<a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a>*       <a class="link" href="gio-Extension-Points.html#g-io-extension-point-get-extension-by-name">g_io_extension_point_get_extension_by_name</a>
75
 
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
 
70
>GType</a>               <a class="link" href="gio-Extension-Points.html#g-io-extension-get-type" title="g_io_extension_get_type ()">g_io_extension_get_type</a>             (<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *extension);
 
71
<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a>*       <a class="link" href="gio-Extension-Points.html#g-io-extension-point-get-extension-by-name" title="g_io_extension_point_get_extension_by_name ()">g_io_extension_point_get_extension_by_name</a>
 
72
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
76
73
                                                         const char *name);
77
74
<a
78
75
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
79
 
>GList</a>*              <a class="link" href="gio-Extension-Points.html#g-io-extension-point-get-extensions">g_io_extension_point_get_extensions</a> (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a> *extension_point);
 
76
>GList</a>*              <a class="link" href="gio-Extension-Points.html#g-io-extension-point-get-extensions" title="g_io_extension_point_get_extensions ()">g_io_extension_point_get_extensions</a> (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point);
80
77
<a
81
78
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
82
 
>GType</a>               <a class="link" href="gio-Extension-Points.html#g-io-extension-point-get-required-type">g_io_extension_point_get_required_type</a>
83
 
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a> *extension_point);
84
 
<a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a>*       <a class="link" href="gio-Extension-Points.html#g-io-extension-point-implement">g_io_extension_point_implement</a>      (const char *extension_point_name,
 
79
>GType</a>               <a class="link" href="gio-Extension-Points.html#g-io-extension-point-get-required-type" title="g_io_extension_point_get_required_type ()">g_io_extension_point_get_required_type</a>
 
80
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point);
 
81
<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a>*       <a class="link" href="gio-Extension-Points.html#g-io-extension-point-implement" title="g_io_extension_point_implement ()">g_io_extension_point_implement</a>      (const char *extension_point_name,
85
82
                                                         <a
86
83
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
87
84
>GType</a> type,
89
86
                                                         <a
90
87
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
91
88
>gint</a> priority);
92
 
<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a>*  <a class="link" href="gio-Extension-Points.html#g-io-extension-point-lookup">g_io_extension_point_lookup</a>         (const char *name);
93
 
<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a>*  <a class="link" href="gio-Extension-Points.html#g-io-extension-point-register">g_io_extension_point_register</a>       (const char *name);
94
 
void                <a class="link" href="gio-Extension-Points.html#g-io-extension-point-set-required-type">g_io_extension_point_set_required_type</a>
95
 
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
 
89
<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a>*  <a class="link" href="gio-Extension-Points.html#g-io-extension-point-lookup" title="g_io_extension_point_lookup ()">g_io_extension_point_lookup</a>         (const char *name);
 
90
<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a>*  <a class="link" href="gio-Extension-Points.html#g-io-extension-point-register" title="g_io_extension_point_register ()">g_io_extension_point_register</a>       (const char *name);
 
91
void                <a class="link" href="gio-Extension-Points.html#g-io-extension-point-set-required-type" title="g_io_extension_point_set_required_type ()">g_io_extension_point_set_required_type</a>
 
92
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
96
93
                                                         <a
97
94
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
98
95
>GType</a> type);
99
96
<a
100
97
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GTypeClass"
101
 
>GTypeClass</a>*         <a class="link" href="gio-Extension-Points.html#g-io-extension-ref-class">g_io_extension_ref_class</a>            (<a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a> *extension);
 
98
>GTypeClass</a>*         <a class="link" href="gio-Extension-Points.html#g-io-extension-ref-class" title="g_io_extension_ref_class ()">g_io_extension_ref_class</a>            (<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *extension);
102
99
</pre>
103
100
</div>
104
101
<div class="refsect1" lang="en">
105
 
<a name="id2899846"></a><h2>Description</h2>
 
102
<a name="gio-Extension-Points.description"></a><h2>Description</h2>
106
103
<p>
107
 
<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a> provides a mechanism for modules to extend the
 
104
<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a> provides a mechanism for modules to extend the
108
105
functionality of the library or application that loaded it in an 
109
106
organized fashion.  
110
107
</p>
111
108
<p>
112
109
An extension point is identified by a name, and it may optionally
113
110
require that any implementation must by of a certain type (or derived
114
 
thereof). Use <a class="link" href="gio-Extension-Points.html#g-io-extension-point-register"><code class="function">g_io_extension_point_register()</code></a> to register an
115
 
extension point, and <a class="link" href="gio-Extension-Points.html#g-io-extension-point-set-required-type"><code class="function">g_io_extension_point_set_required_type()</code></a> to
 
111
thereof). Use <a class="link" href="gio-Extension-Points.html#g-io-extension-point-register" title="g_io_extension_point_register ()"><code class="function">g_io_extension_point_register()</code></a> to register an
 
112
extension point, and <a class="link" href="gio-Extension-Points.html#g-io-extension-point-set-required-type" title="g_io_extension_point_set_required_type ()"><code class="function">g_io_extension_point_set_required_type()</code></a> to
116
113
set a required type.
117
114
</p>
118
115
<p>
121
118
><span class="type">GType</span></a> 
122
119
that implements the functionality. Additionally, each implementation
123
120
of an extension point has a name, and a priority. Use
124
 
<a class="link" href="gio-Extension-Points.html#g-io-extension-point-implement"><code class="function">g_io_extension_point_implement()</code></a> to implement an extension point.
 
121
<a class="link" href="gio-Extension-Points.html#g-io-extension-point-implement" title="g_io_extension_point_implement ()"><code class="function">g_io_extension_point_implement()</code></a> to implement an extension point.
125
122
</p>
126
123
<p>
127
124
 </p>
157
154
</p>
158
155
</div>
159
156
<div class="refsect1" lang="en">
160
 
<a name="id2899959"></a><h2>Details</h2>
161
 
<div class="refsect2" lang="en">
162
 
<a name="id2899970"></a><h3>
163
 
<a name="GIOExtension"></a>GIOExtension</h3>
164
 
<a class="indexterm" name="id2899983"></a><pre class="programlisting">typedef struct _GIOExtension GIOExtension;</pre>
165
 
<p>
166
 
 
167
 
</p>
168
 
</div>
169
 
<hr>
170
 
<div class="refsect2" lang="en">
171
 
<a name="id2899999"></a><h3>
172
 
<a name="GIOExtensionPoint"></a>GIOExtensionPoint</h3>
173
 
<a class="indexterm" name="id2900011"></a><pre class="programlisting">typedef struct _GIOExtensionPoint GIOExtensionPoint;</pre>
174
 
<p>
175
 
 
176
 
</p>
177
 
</div>
178
 
<hr>
179
 
<div class="refsect2" lang="en">
180
 
<a name="id2900028"></a><h3>
181
 
<a name="g-io-extension-get-name"></a>g_io_extension_get_name ()</h3>
182
 
<a class="indexterm" name="id2900039"></a><pre class="programlisting">const char*         g_io_extension_get_name             (<a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a> *extension);</pre>
 
157
<a name="gio-Extension-Points.details"></a><h2>Details</h2>
 
158
<div class="refsect2" lang="en">
 
159
<a name="GIOExtension"></a><h3>GIOExtension</h3>
 
160
<pre class="programlisting">typedef struct _GIOExtension GIOExtension;</pre>
 
161
<p>
 
162
 
 
163
</p>
 
164
</div>
 
165
<hr>
 
166
<div class="refsect2" lang="en">
 
167
<a name="GIOExtensionPoint"></a><h3>GIOExtensionPoint</h3>
 
168
<pre class="programlisting">typedef struct _GIOExtensionPoint GIOExtensionPoint;</pre>
 
169
<p>
 
170
 
 
171
</p>
 
172
</div>
 
173
<hr>
 
174
<div class="refsect2" lang="en">
 
175
<a name="g-io-extension-get-name"></a><h3>g_io_extension_get_name ()</h3>
 
176
<pre class="programlisting">const char*         g_io_extension_get_name             (<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *extension);</pre>
183
177
<p>
184
178
Gets the name under which <em class="parameter"><code>extension</code></em> was registered.
185
179
</p>
193
187
<col align="left" valign="top">
194
188
<tbody>
195
189
<tr>
196
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em>&#160;:</span></p></td>
197
 
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension"><span class="type">GIOExtension</span></a>
 
190
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
 
191
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a>
198
192
</td>
199
193
</tr>
200
194
<tr>
201
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
195
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
202
196
<td> the name of <em class="parameter"><code>extension</code></em>.
203
197
</td>
204
198
</tr>
207
201
</div>
208
202
<hr>
209
203
<div class="refsect2" lang="en">
210
 
<a name="id2900126"></a><h3>
211
 
<a name="g-io-extension-get-priority"></a>g_io_extension_get_priority ()</h3>
212
 
<a class="indexterm" name="id2900137"></a><pre class="programlisting"><a
 
204
<a name="g-io-extension-get-priority"></a><h3>g_io_extension_get_priority ()</h3>
 
205
<pre class="programlisting"><a
213
206
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
214
 
>gint</a>                g_io_extension_get_priority         (<a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a> *extension);</pre>
 
207
>gint</a>                g_io_extension_get_priority         (<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *extension);</pre>
215
208
<p>
216
209
Gets the priority with which <em class="parameter"><code>extension</code></em> was registered.</p>
217
210
<p>
221
214
<col align="left" valign="top">
222
215
<tbody>
223
216
<tr>
224
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em>&#160;:</span></p></td>
225
 
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension"><span class="type">GIOExtension</span></a>
 
217
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
 
218
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a>
226
219
</td>
227
220
</tr>
228
221
<tr>
229
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
222
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
230
223
<td> the priority of <em class="parameter"><code>extension</code></em>
231
224
</td>
232
225
</tr>
235
228
</div>
236
229
<hr>
237
230
<div class="refsect2" lang="en">
238
 
<a name="id2900217"></a><h3>
239
 
<a name="g-io-extension-get-type"></a>g_io_extension_get_type ()</h3>
240
 
<a class="indexterm" name="id2900228"></a><pre class="programlisting"><a
 
231
<a name="g-io-extension-get-type"></a><h3>g_io_extension_get_type ()</h3>
 
232
<pre class="programlisting"><a
241
233
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
242
 
>GType</a>               g_io_extension_get_type             (<a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a> *extension);</pre>
 
234
>GType</a>               g_io_extension_get_type             (<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *extension);</pre>
243
235
<p>
244
236
Gets the type associated with <em class="parameter"><code>extension</code></em>.</p>
245
237
<p>
249
241
<col align="left" valign="top">
250
242
<tbody>
251
243
<tr>
252
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em>&#160;:</span></p></td>
253
 
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension"><span class="type">GIOExtension</span></a>
 
244
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
 
245
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a>
254
246
</td>
255
247
</tr>
256
248
<tr>
257
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
249
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
258
250
<td> the type of <em class="parameter"><code>extension</code></em>
259
251
</td>
260
252
</tr>
263
255
</div>
264
256
<hr>
265
257
<div class="refsect2" lang="en">
266
 
<a name="id2902520"></a><h3>
267
 
<a name="g-io-extension-point-get-extension-by-name"></a>g_io_extension_point_get_extension_by_name ()</h3>
268
 
<a class="indexterm" name="id2902535"></a><pre class="programlisting"><a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a>*       g_io_extension_point_get_extension_by_name
269
 
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
 
258
<a name="g-io-extension-point-get-extension-by-name"></a><h3>g_io_extension_point_get_extension_by_name ()</h3>
 
259
<pre class="programlisting"><a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a>*       g_io_extension_point_get_extension_by_name
 
260
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
270
261
                                                         const char *name);</pre>
271
262
<p>
272
 
Finds a <a class="link" href="gio-Extension-Points.html#GIOExtension"><span class="type">GIOExtension</span></a> for an extension point by name.</p>
 
263
Finds a <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a> for an extension point by name.</p>
273
264
<p>
274
265
 
275
266
</p>
277
268
<col align="left" valign="top">
278
269
<tbody>
279
270
<tr>
280
 
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em>&#160;:</span></p></td>
281
 
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
 
271
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em> :</span></p></td>
 
272
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
282
273
</td>
283
274
</tr>
284
275
<tr>
285
 
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
 
276
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
286
277
<td> the name of the extension to get
287
278
</td>
288
279
</tr>
289
280
<tr>
290
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
291
 
<td> the <a class="link" href="gio-Extension-Points.html#GIOExtension"><span class="type">GIOExtension</span></a> for <em class="parameter"><code>extension_point</code></em> that has the
 
281
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
282
<td> the <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a> for <em class="parameter"><code>extension_point</code></em> that has the
292
283
   given name, or <a
293
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
 
284
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
294
285
><code class="literal">NULL</code></a> if there is no extension with that name
295
286
</td>
296
287
</tr>
299
290
</div>
300
291
<hr>
301
292
<div class="refsect2" lang="en">
302
 
<a name="id2902655"></a><h3>
303
 
<a name="g-io-extension-point-get-extensions"></a>g_io_extension_point_get_extensions ()</h3>
304
 
<a class="indexterm" name="id2902667"></a><pre class="programlisting"><a
 
293
<a name="g-io-extension-point-get-extensions"></a><h3>g_io_extension_point_get_extensions ()</h3>
 
294
<pre class="programlisting"><a
305
295
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
306
 
>GList</a>*              g_io_extension_point_get_extensions (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a> *extension_point);</pre>
 
296
>GList</a>*              g_io_extension_point_get_extensions (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point);</pre>
307
297
<p>
308
298
Gets a list of all extensions that implement this extension point.
309
299
The list is sorted by priority, beginning with the highest priority.</p>
314
304
<col align="left" valign="top">
315
305
<tbody>
316
306
<tr>
317
 
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em>&#160;:</span></p></td>
318
 
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
 
307
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em> :</span></p></td>
 
308
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
319
309
</td>
320
310
</tr>
321
311
<tr>
322
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
312
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
323
313
<td> a <a
324
314
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
325
 
><span class="type">GList</span></a> of <a class="link" href="gio-Extension-Points.html#GIOExtension"><span class="type">GIOExtension</span></a>s. The list is owned by
 
315
><span class="type">GList</span></a> of <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a>s. The list is owned by
326
316
  GIO and should not be modified
327
317
</td>
328
318
</tr>
331
321
</div>
332
322
<hr>
333
323
<div class="refsect2" lang="en">
334
 
<a name="id2902754"></a><h3>
335
 
<a name="g-io-extension-point-get-required-type"></a>g_io_extension_point_get_required_type ()</h3>
336
 
<a class="indexterm" name="id2902768"></a><pre class="programlisting"><a
 
324
<a name="g-io-extension-point-get-required-type"></a><h3>g_io_extension_point_get_required_type ()</h3>
 
325
<pre class="programlisting"><a
337
326
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
338
327
>GType</a>               g_io_extension_point_get_required_type
339
 
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a> *extension_point);</pre>
 
328
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point);</pre>
340
329
<p>
341
330
Gets the required type for <em class="parameter"><code>extension_point</code></em>.</p>
342
331
<p>
346
335
<col align="left" valign="top">
347
336
<tbody>
348
337
<tr>
349
 
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em>&#160;:</span></p></td>
350
 
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
 
338
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em> :</span></p></td>
 
339
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
351
340
</td>
352
341
</tr>
353
342
<tr>
354
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
343
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
355
344
<td> the <a
356
345
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
357
346
><span class="type">GType</span></a> that all implementations must have, 
365
354
</div>
366
355
<hr>
367
356
<div class="refsect2" lang="en">
368
 
<a name="id2902859"></a><h3>
369
 
<a name="g-io-extension-point-implement"></a>g_io_extension_point_implement ()</h3>
370
 
<a class="indexterm" name="id2902870"></a><pre class="programlisting"><a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a>*       g_io_extension_point_implement      (const char *extension_point_name,
 
357
<a name="g-io-extension-point-implement"></a><h3>g_io_extension_point_implement ()</h3>
 
358
<pre class="programlisting"><a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a>*       g_io_extension_point_implement      (const char *extension_point_name,
371
359
                                                         <a
372
360
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
373
361
>GType</a> type,
381
369
</p>
382
370
<p>
383
371
If <em class="parameter"><code>type</code></em> has already been registered as an extension for this 
384
 
extension point, the existing <a class="link" href="gio-Extension-Points.html#GIOExtension"><span class="type">GIOExtension</span></a> object is returned.</p>
 
372
extension point, the existing <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a> object is returned.</p>
385
373
<p>
386
374
 
387
375
</p>
389
377
<col align="left" valign="top">
390
378
<tbody>
391
379
<tr>
392
 
<td><p><span class="term"><em class="parameter"><code>extension_point_name</code></em>&#160;:</span></p></td>
 
380
<td><p><span class="term"><em class="parameter"><code>extension_point_name</code></em> :</span></p></td>
393
381
<td> the name of the extension point
394
382
</td>
395
383
</tr>
396
384
<tr>
397
 
<td><p><span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></p></td>
 
385
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
398
386
<td> the <a
399
387
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
400
388
><span class="type">GType</span></a> to register as extension 
401
389
</td>
402
390
</tr>
403
391
<tr>
404
 
<td><p><span class="term"><em class="parameter"><code>extension_name</code></em>&#160;:</span></p></td>
 
392
<td><p><span class="term"><em class="parameter"><code>extension_name</code></em> :</span></p></td>
405
393
<td> the name for the extension
406
394
</td>
407
395
</tr>
408
396
<tr>
409
 
<td><p><span class="term"><em class="parameter"><code>priority</code></em>&#160;:</span></p></td>
 
397
<td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
410
398
<td> the priority for the extension
411
399
</td>
412
400
</tr>
413
401
<tr>
414
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
415
 
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension"><span class="type">GIOExtension</span></a> object for <a
 
402
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
403
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a> object for <a
416
404
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
417
405
><span class="type">GType</span></a>
418
406
</td>
422
410
</div>
423
411
<hr>
424
412
<div class="refsect2" lang="en">
425
 
<a name="id2903045"></a><h3>
426
 
<a name="g-io-extension-point-lookup"></a>g_io_extension_point_lookup ()</h3>
427
 
<a class="indexterm" name="id2903057"></a><pre class="programlisting"><a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a>*  g_io_extension_point_lookup         (const char *name);</pre>
 
413
<a name="g-io-extension-point-lookup"></a><h3>g_io_extension_point_lookup ()</h3>
 
414
<pre class="programlisting"><a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a>*  g_io_extension_point_lookup         (const char *name);</pre>
428
415
<p>
429
416
Looks up an existing extension point.</p>
430
417
<p>
434
421
<col align="left" valign="top">
435
422
<tbody>
436
423
<tr>
437
 
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
 
424
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
438
425
<td> the name of the extension point
439
426
</td>
440
427
</tr>
441
428
<tr>
442
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
443
 
<td> the <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>, or <a
444
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
 
429
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
430
<td> the <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>, or <a
 
431
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
445
432
><code class="literal">NULL</code></a> if there is no
446
433
   registered extension point with the given name
447
434
</td>
451
438
</div>
452
439
<hr>
453
440
<div class="refsect2" lang="en">
454
 
<a name="id2903135"></a><h3>
455
 
<a name="g-io-extension-point-register"></a>g_io_extension_point_register ()</h3>
456
 
<a class="indexterm" name="id2903146"></a><pre class="programlisting"><a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a>*  g_io_extension_point_register       (const char *name);</pre>
 
441
<a name="g-io-extension-point-register"></a><h3>g_io_extension_point_register ()</h3>
 
442
<pre class="programlisting"><a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a>*  g_io_extension_point_register       (const char *name);</pre>
457
443
<p>
458
444
Registers an extension point.</p>
459
445
<p>
463
449
<col align="left" valign="top">
464
450
<tbody>
465
451
<tr>
466
 
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
 
452
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
467
453
<td> The name of the extension point
468
454
</td>
469
455
</tr>
470
456
<tr>
471
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
472
 
<td> the new <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>. This object is owned by GIO
 
457
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
458
<td> the new <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>. This object is owned by GIO
473
459
   and should not be freed
474
460
</td>
475
461
</tr>
478
464
</div>
479
465
<hr>
480
466
<div class="refsect2" lang="en">
481
 
<a name="id2903214"></a><h3>
482
 
<a name="g-io-extension-point-set-required-type"></a>g_io_extension_point_set_required_type ()</h3>
483
 
<a class="indexterm" name="id2903227"></a><pre class="programlisting">void                g_io_extension_point_set_required_type
484
 
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
 
467
<a name="g-io-extension-point-set-required-type"></a><h3>g_io_extension_point_set_required_type ()</h3>
 
468
<pre class="programlisting">void                g_io_extension_point_set_required_type
 
469
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
485
470
                                                         <a
486
471
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
487
472
>GType</a> type);</pre>
495
480
<col align="left" valign="top">
496
481
<tbody>
497
482
<tr>
498
 
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em>&#160;:</span></p></td>
499
 
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
 
483
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em> :</span></p></td>
 
484
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
500
485
</td>
501
486
</tr>
502
487
<tr>
503
 
<td><p><span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></p></td>
 
488
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
504
489
<td> the <a
505
490
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
506
491
><span class="type">GType</span></a> to require
511
496
</div>
512
497
<hr>
513
498
<div class="refsect2" lang="en">
514
 
<a name="id2903328"></a><h3>
515
 
<a name="g-io-extension-ref-class"></a>g_io_extension_ref_class ()</h3>
516
 
<a class="indexterm" name="id2903339"></a><pre class="programlisting"><a
 
499
<a name="g-io-extension-ref-class"></a><h3>g_io_extension_ref_class ()</h3>
 
500
<pre class="programlisting"><a
517
501
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GTypeClass"
518
 
>GTypeClass</a>*         g_io_extension_ref_class            (<a class="link" href="gio-Extension-Points.html#GIOExtension">GIOExtension</a> *extension);</pre>
 
502
>GTypeClass</a>*         g_io_extension_ref_class            (<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *extension);</pre>
519
503
<p>
520
504
Gets a reference to the class for the type that is 
521
505
associated with <em class="parameter"><code>extension</code></em>.</p>
526
510
<col align="left" valign="top">
527
511
<tbody>
528
512
<tr>
529
 
<td><p><span class="term"><em class="parameter"><code>extension</code></em>&#160;:</span></p></td>
530
 
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension"><span class="type">GIOExtension</span></a>
 
513
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
 
514
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a>
531
515
</td>
532
516
</tr>
533
517
<tr>
534
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
518
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
535
519
<td> the <a
536
520
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GTypeClass"
537
521
><span class="type">GTypeClass</span></a> for the type of <em class="parameter"><code>extension</code></em>
542
526
</div>
543
527
</div>
544
528
<div class="refsect1" lang="en">
545
 
<a name="id2903428"></a><h2>See Also</h2>
 
529
<a name="gio-Extension-Points.see-also"></a><h2>See Also</h2>
546
530
Extending GIO
547
531
</div>
548
 
<div class="refsect1" lang="en">
549
 
<a name="id2903442"></a><div class="refsect2" lang="en"><a name="id2903443"></a></div>
 
532
</div>
 
533
<div class="footer">
550
534
<hr>
551
 
<div class="refsect2" lang="en"><a name="id2903444"></a></div>
552
 
</div>
553
 
</div>
 
535
          Generated by GTK-Doc V1.10</div>
554
536
</body>
555
537
</html>