← Back to branch summary

~ubuntu-branches/debian/squeeze/glib2.0/squeeze

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Gustavo Noronha Silva
  • Date: 2009-02-15 13:00:43 UTC
  • mfrom: (1.3.1 upstream) (69.1.10 intrepid)
  • Revision ID: james.westby@ubuntu.com-20090215130043-q47fbt3owmt42m2f
Tags: 2.18.4-2
* Release to unstable
* debian/rules:
- bump SHVER, since we are already forcing a 2.18.0 dependecy on the
  symbols introduced in the development versions
* debian/control.in:
- added Homepage and Vcs-* control fields

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.11 (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
 
<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">
 
17
<link rel="chapter" href="extending-gio.html" title="Extending GIO">
 
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">
32
32
<link rel="index" href="ix01.html" title="Index">
 
33
<link rel="index" href="ix02.html" title="Index of new symbols in 2.18">
33
34
</head>
34
35
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
35
36
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
40
41
<th width="100%" align="center">GIO Reference Manual</th>
41
42
<td><a accesskey="n" href="migrating.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
42
43
</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>
 
44
<tr><td colspan="5" class="shortcuts">
 
45
<a href="#gio-Extension-Points.synopsis" class="shortcut">Top</a>
 
46
                 | 
 
47
                <a href="#gio-Extension-Points.description" class="shortcut">Description</a>
 
48
</td></tr>
46
49
</table>
47
50
<div class="refentry" lang="en">
48
51
<a name="gio-Extension-Points"></a><div class="titlepage"></div>
49
52
<div class="refnamediv"><table width="100%"><tr>
50
53
<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>
 
54
<h2><span class="refentrytitle"><a name="gio-Extension-Points.top_of_page"></a>Extension Points</span></h2>
 
55
<p>Extension Points — Extension Points</p>
55
56
</td>
56
57
<td valign="top" align="right"></td>
57
58
</tr></table></div>
58
59
<div class="refsynopsisdiv">
59
 
<h2>Synopsis</h2>
 
60
<a name="gio-Extension-Points.synopsis"></a><h2>Synopsis</h2>
60
61
<pre class="synopsis">
61
62
 
62
63
#include &lt;gio.h&gt;
63
64
 
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);
 
65
                    <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a>;
 
66
                    <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a>;
 
67
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
68
<a
69
69
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);
 
70
>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
71
<a
72
72
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,
 
73
>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);
 
74
<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>
 
75
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
76
76
                                                         const char *name);
77
77
<a
78
78
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);
 
79
>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
80
<a
81
81
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,
 
82
>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>
 
83
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point);
 
84
<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
85
                                                         <a
86
86
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
87
87
>GType</a> type,
89
89
                                                         <a
90
90
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
91
91
>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,
 
92
<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);
 
93
<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);
 
94
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>
 
95
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
96
96
                                                         <a
97
97
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
98
98
>GType</a> type);
99
99
<a
100
100
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);
 
101
>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
102
</pre>
103
103
</div>
104
104
<div class="refsect1" lang="en">
105
 
<a name="id2899846"></a><h2>Description</h2>
 
105
<a name="gio-Extension-Points.description"></a><h2>Description</h2>
106
106
<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
 
107
<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
108
functionality of the library or application that loaded it in an 
109
109
organized fashion.  
110
110
</p>
111
111
<p>
112
112
An extension point is identified by a name, and it may optionally
113
113
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
 
114
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
 
115
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
116
set a required type.
117
117
</p>
118
118
<p>
121
121
><span class="type">GType</span></a> 
122
122
that implements the functionality. Additionally, each implementation
123
123
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.
 
124
<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
125
</p>
126
126
<p>
127
127
 </p>
153
153
 only the one with the highest priority, or pick a specific
154
154
 one by name.</p>
155
155
<p>
156
 
 
157
156
</p>
158
157
</div>
159
158
<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>
 
159
<a name="gio-Extension-Points.details"></a><h2>Details</h2>
 
160
<div class="refsect2" lang="en">
 
161
<a name="GIOExtension"></a><h3>GIOExtension</h3>
 
162
<pre class="programlisting">typedef struct _GIOExtension GIOExtension;</pre>
 
163
<p>
 
164
</p>
 
165
</div>
 
166
<hr>
 
167
<div class="refsect2" lang="en">
 
168
<a name="GIOExtensionPoint"></a><h3>GIOExtensionPoint</h3>
 
169
<pre class="programlisting">typedef struct _GIOExtensionPoint GIOExtensionPoint;</pre>
 
170
<p>
 
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>
187
181
Note that the same type may be registered as extension
188
182
for multiple extension points, under different names.</p>
189
183
<p>
190
 
 
191
184
</p>
192
185
<div class="variablelist"><table border="0">
193
186
<col align="left" valign="top">
194
187
<tbody>
195
188
<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>
 
189
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
 
190
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a>
198
191
</td>
199
192
</tr>
200
193
<tr>
201
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
194
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
202
195
<td> the name of <em class="parameter"><code>extension</code></em>.
203
196
</td>
204
197
</tr>
207
200
</div>
208
201
<hr>
209
202
<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
 
203
<a name="g-io-extension-get-priority"></a><h3>g_io_extension_get_priority ()</h3>
 
204
<pre class="programlisting"><a
213
205
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>
 
206
>gint</a>                g_io_extension_get_priority         (<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *extension);</pre>
215
207
<p>
216
208
Gets the priority with which <em class="parameter"><code>extension</code></em> was registered.</p>
217
209
<p>
218
 
 
219
210
</p>
220
211
<div class="variablelist"><table border="0">
221
212
<col align="left" valign="top">
222
213
<tbody>
223
214
<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>
 
215
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
 
216
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a>
226
217
</td>
227
218
</tr>
228
219
<tr>
229
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
220
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
230
221
<td> the priority of <em class="parameter"><code>extension</code></em>
231
222
</td>
232
223
</tr>
235
226
</div>
236
227
<hr>
237
228
<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
 
229
<a name="g-io-extension-get-type"></a><h3>g_io_extension_get_type ()</h3>
 
230
<pre class="programlisting"><a
241
231
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>
 
232
>GType</a>               g_io_extension_get_type             (<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *extension);</pre>
243
233
<p>
244
234
Gets the type associated with <em class="parameter"><code>extension</code></em>.</p>
245
235
<p>
246
 
 
247
236
</p>
248
237
<div class="variablelist"><table border="0">
249
238
<col align="left" valign="top">
250
239
<tbody>
251
240
<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>
 
241
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
 
242
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a>
254
243
</td>
255
244
</tr>
256
245
<tr>
257
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
246
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
258
247
<td> the type of <em class="parameter"><code>extension</code></em>
259
248
</td>
260
249
</tr>
263
252
</div>
264
253
<hr>
265
254
<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,
 
255
<a name="g-io-extension-point-get-extension-by-name"></a><h3>g_io_extension_point_get_extension_by_name ()</h3>
 
256
<pre class="programlisting"><a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *      g_io_extension_point_get_extension_by_name
 
257
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
270
258
                                                         const char *name);</pre>
271
259
<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>
 
260
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
261
<p>
274
 
 
275
262
</p>
276
263
<div class="variablelist"><table border="0">
277
264
<col align="left" valign="top">
278
265
<tbody>
279
266
<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>
 
267
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em> :</span></p></td>
 
268
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
282
269
</td>
283
270
</tr>
284
271
<tr>
285
 
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
 
272
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
286
273
<td> the name of the extension to get
287
274
</td>
288
275
</tr>
289
276
<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
 
277
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
278
<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
279
   given name, or <a
293
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
 
280
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
294
281
><code class="literal">NULL</code></a> if there is no extension with that name
295
282
</td>
296
283
</tr>
299
286
</div>
300
287
<hr>
301
288
<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
 
289
<a name="g-io-extension-point-get-extensions"></a><h3>g_io_extension_point_get_extensions ()</h3>
 
290
<pre class="programlisting"><a
305
291
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>
 
292
>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
293
<p>
308
294
Gets a list of all extensions that implement this extension point.
309
295
The list is sorted by priority, beginning with the highest priority.</p>
310
296
<p>
311
 
 
312
297
</p>
313
298
<div class="variablelist"><table border="0">
314
299
<col align="left" valign="top">
315
300
<tbody>
316
301
<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>
 
302
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em> :</span></p></td>
 
303
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
319
304
</td>
320
305
</tr>
321
306
<tr>
322
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
307
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
323
308
<td> a <a
324
309
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
 
310
><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
311
  GIO and should not be modified
327
312
</td>
328
313
</tr>
331
316
</div>
332
317
<hr>
333
318
<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
 
319
<a name="g-io-extension-point-get-required-type"></a><h3>g_io_extension_point_get_required_type ()</h3>
 
320
<pre class="programlisting"><a
337
321
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
338
322
>GType</a>               g_io_extension_point_get_required_type
339
 
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint">GIOExtensionPoint</a> *extension_point);</pre>
 
323
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point);</pre>
340
324
<p>
341
325
Gets the required type for <em class="parameter"><code>extension_point</code></em>.</p>
342
326
<p>
343
 
 
344
327
</p>
345
328
<div class="variablelist"><table border="0">
346
329
<col align="left" valign="top">
347
330
<tbody>
348
331
<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>
 
332
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em> :</span></p></td>
 
333
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
351
334
</td>
352
335
</tr>
353
336
<tr>
354
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
337
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
355
338
<td> the <a
356
339
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
357
340
><span class="type">GType</span></a> that all implementations must have, 
358
341
    or <a
359
 
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-TYPE-INVALID:CAPS"
 
342
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-TYPE-INVALID--CAPS"
360
343
><span class="type">G_TYPE_INVALID</span></a> if the extension point has no required type
361
344
</td>
362
345
</tr>
365
348
</div>
366
349
<hr>
367
350
<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,
 
351
<a name="g-io-extension-point-implement"></a><h3>g_io_extension_point_implement ()</h3>
 
352
<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
353
                                                         <a
372
354
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
373
355
>GType</a> type,
381
363
</p>
382
364
<p>
383
365
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>
 
366
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
367
<p>
386
 
 
387
368
</p>
388
369
<div class="variablelist"><table border="0">
389
370
<col align="left" valign="top">
390
371
<tbody>
391
372
<tr>
392
 
<td><p><span class="term"><em class="parameter"><code>extension_point_name</code></em>&#160;:</span></p></td>
 
373
<td><p><span class="term"><em class="parameter"><code>extension_point_name</code></em> :</span></p></td>
393
374
<td> the name of the extension point
394
375
</td>
395
376
</tr>
396
377
<tr>
397
 
<td><p><span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></p></td>
 
378
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
398
379
<td> the <a
399
380
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
400
381
><span class="type">GType</span></a> to register as extension 
401
382
</td>
402
383
</tr>
403
384
<tr>
404
 
<td><p><span class="term"><em class="parameter"><code>extension_name</code></em>&#160;:</span></p></td>
 
385
<td><p><span class="term"><em class="parameter"><code>extension_name</code></em> :</span></p></td>
405
386
<td> the name for the extension
406
387
</td>
407
388
</tr>
408
389
<tr>
409
 
<td><p><span class="term"><em class="parameter"><code>priority</code></em>&#160;:</span></p></td>
 
390
<td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
410
391
<td> the priority for the extension
411
392
</td>
412
393
</tr>
413
394
<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
 
395
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
396
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a> object for <a
416
397
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
417
398
><span class="type">GType</span></a>
418
399
</td>
422
403
</div>
423
404
<hr>
424
405
<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>
 
406
<a name="g-io-extension-point-lookup"></a><h3>g_io_extension_point_lookup ()</h3>
 
407
<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
408
<p>
429
409
Looks up an existing extension point.</p>
430
410
<p>
431
 
 
432
411
</p>
433
412
<div class="variablelist"><table border="0">
434
413
<col align="left" valign="top">
435
414
<tbody>
436
415
<tr>
437
 
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
 
416
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
438
417
<td> the name of the extension point
439
418
</td>
440
419
</tr>
441
420
<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"
 
421
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
422
<td> the <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>, or <a
 
423
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
445
424
><code class="literal">NULL</code></a> if there is no
446
425
   registered extension point with the given name
447
426
</td>
451
430
</div>
452
431
<hr>
453
432
<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>
 
433
<a name="g-io-extension-point-register"></a><h3>g_io_extension_point_register ()</h3>
 
434
<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
435
<p>
458
436
Registers an extension point.</p>
459
437
<p>
460
 
 
461
438
</p>
462
439
<div class="variablelist"><table border="0">
463
440
<col align="left" valign="top">
464
441
<tbody>
465
442
<tr>
466
 
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
 
443
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
467
444
<td> The name of the extension point
468
445
</td>
469
446
</tr>
470
447
<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
 
448
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
449
<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
450
   and should not be freed
474
451
</td>
475
452
</tr>
478
455
</div>
479
456
<hr>
480
457
<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,
 
458
<a name="g-io-extension-point-set-required-type"></a><h3>g_io_extension_point_set_required_type ()</h3>
 
459
<pre class="programlisting">void                g_io_extension_point_set_required_type
 
460
                                                        (<a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint">GIOExtensionPoint</a> *extension_point,
485
461
                                                         <a
486
462
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
487
463
>GType</a> type);</pre>
489
465
Sets the required type for <em class="parameter"><code>extension_point</code></em> to <em class="parameter"><code>type</code></em>. 
490
466
All implementations must henceforth have this type.</p>
491
467
<p>
492
 
 
493
468
</p>
494
469
<div class="variablelist"><table border="0">
495
470
<col align="left" valign="top">
496
471
<tbody>
497
472
<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>
 
473
<td><p><span class="term"><em class="parameter"><code>extension_point</code></em> :</span></p></td>
 
474
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtensionPoint" title="GIOExtensionPoint"><span class="type">GIOExtensionPoint</span></a>
500
475
</td>
501
476
</tr>
502
477
<tr>
503
 
<td><p><span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></p></td>
 
478
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
504
479
<td> the <a
505
480
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
506
481
><span class="type">GType</span></a> to require
511
486
</div>
512
487
<hr>
513
488
<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
 
489
<a name="g-io-extension-ref-class"></a><h3>g_io_extension_ref_class ()</h3>
 
490
<pre class="programlisting"><a
517
491
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>
 
492
>GTypeClass</a>*         g_io_extension_ref_class            (<a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension">GIOExtension</a> *extension);</pre>
519
493
<p>
520
494
Gets a reference to the class for the type that is 
521
495
associated with <em class="parameter"><code>extension</code></em>.</p>
522
496
<p>
523
 
 
524
497
</p>
525
498
<div class="variablelist"><table border="0">
526
499
<col align="left" valign="top">
527
500
<tbody>
528
501
<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>
 
502
<td><p><span class="term"><em class="parameter"><code>extension</code></em> :</span></p></td>
 
503
<td> a <a class="link" href="gio-Extension-Points.html#GIOExtension" title="GIOExtension"><span class="type">GIOExtension</span></a>
531
504
</td>
532
505
</tr>
533
506
<tr>
534
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
507
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
535
508
<td> the <a
536
509
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GTypeClass"
537
510
><span class="type">GTypeClass</span></a> for the type of <em class="parameter"><code>extension</code></em>
542
515
</div>
543
516
</div>
544
517
<div class="refsect1" lang="en">
545
 
<a name="id2903428"></a><h2>See Also</h2>
 
518
<a name="gio-Extension-Points.see-also"></a><h2>See Also</h2>
546
519
Extending GIO
547
520
</div>
548
 
<div class="refsect1" lang="en">
549
 
<a name="id2903442"></a><div class="refsect2" lang="en"><a name="id2903443"></a></div>
 
521
</div>
 
522
<div class="footer">
550
523
<hr>
551
 
<div class="refsect2" lang="en"><a name="id2903444"></a></div>
552
 
</div>
553
 
</div>
 
524
          Generated by GTK-Doc V1.11</div>
554
525
</body>
555
526
</html>