~ubuntu-branches/ubuntu/utopic/evolution-data-server/utopic-proposed

void <a class="link" href="eds-EExtensible.html#e-extensible-load-extensions" title="e_extensible_load_extensions ()">e_extensible_load_extensions</a> (<code>EExtensible *extensible</code>);

GList * <a class="link" href="eds-EExtensible.html#e-extensible-list-extensions" title="e_extensible_list_extensions ()">e_extensible_list_extensions</a> (<code>EExtensible *extensible</code>,

<code>GType extension_type</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> * <a class="link" href="eds-EExtensible.html#e-extensible-list-extensions" title="e_extensible_list_extensions ()">e_extensible_list_extensions</a> (<code>EExtensible *extensible</code>,

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> extension_type</code>);

</pre>

</div>

<a name="eds-EExtensible.description"></a><h2>Description</h2>

<a class="link" href="eds-EExtension.html#EExtension" title="struct EExtension">EExtension</a> objects can be tacked on to any GObject instance that

implements the EExtensible interface. A GObject type can be made

<a class="link" href="eds-EExtension.html#EExtension" title="struct EExtension">EExtension</a> objects can be tacked on to any <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> instance that

implements the EExtensible interface. A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> type can be made

extensible in two steps:

1. Add the EExtensible interface when registering the GType.

1. Add the EExtensible interface when registering the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a>.

There are no methods to implement.

5</pre></td>

<td class="listing_code"><pre class="programlisting">#include <libebackend/libebackend.h>

<td class="listing_code"><pre class="programlisting">#include <libebackend/libebackend.h>

G_DEFINE_TYPE_WITH_CODE (

ECustomWidget, e_custom_widget, GTK_TYPE_WIDGET,

G_IMPLEMENT_INTERFACE (E_TYPE_EXTENSIBLE, NULL))</pre></td>

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-DEFINE-TYPE-WITH-CODE:CAPS">G_DEFINE_TYPE_WITH_CODE</a> (

ECustomWidget, e_custom_widget, GTK_TYPE_WIDGET,

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#G-IMPLEMENT-INTERFACE:CAPS">G_IMPLEMENT_INTERFACE</a> (E_TYPE_EXTENSIBLE, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>))</pre></td>

</tr>

</tbody>

</table>

2. Load extensions for the class at some point during GObject

2. Load extensions for the class at some point during <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

initialization. Generally this should be done toward the end of

the initialization code, so extensions get a fully initialized

object to work with.

100

101

7</pre></td>

102

<td class="listing_code"><pre class="programlisting">static void

103

e_custom_widget_constructed (ECustomWidget *widget)

104

{

105

Construction code goes here, same as call to parent's 'constructed'...

106

102

<td class="listing_code"><pre class="programlisting">static void

103

e_custom_widget_constructed (ECustomWidget *widget)

104

{

105

Construction code goes here, same as call to parent's 'constructed'...

106

107

e_extensible_load_extensions (E_EXTENSIBLE (widget));

108

}</pre></td>

109

</tr>

133

<a class="link" href="eds-EExtension.html#EExtension" title="struct EExtension">EExtension</a> objects are bound to <code>extensible</code> such that they are finalized

134

when <code>extensible</code> is finalized.

135

136

136

137

137

138

139

<col>

140

</colgroup>

138

141

139

142

<td><code>extensible</code> :</td>

140

143

<td>an EExtensible

146

149

<hr>

147

150

148

151

<a name="e-extensible-list-extensions"></a><h3>e_extensible_list_extensions ()</h3>

149

<pre class="programlisting">GList * e_extensible_list_extensions (<code>EExtensible *extensible</code>,

150

<code>GType extension_type</code>);</pre>

152

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> * e_extensible_list_extensions (<code>EExtensible *extensible</code>,

153

<code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> extension_type</code>);</pre>

151

154

152

155

Returns a list of <a class="link" href="eds-EExtension.html#EExtension" title="struct EExtension">EExtension</a> objects bound to <code>extensible</code> whose

153

156

types are ancestors of <code>extension_type</code>. For a complete list of

154

157

extension objects bound to <code>extensible</code>, pass <code class="literal">E_TYPE_EXTENSION</code>.

155

158

156

159

157

The list itself should be freed with <code class="function">g_list_free()</code>. The extension

160

The list itself should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>. The extension

158

161

objects are owned by <code>extensible</code> and should not be unreferenced.

159

162

160

163

164

161

165

166

<col>

167

</colgroup>

162

168

<tbody>

163

169

<tr>

164

170

<td><code>extensible</code> :</td>

Older »