|
|
|
GIO Reference Manual | |
|---|---|---|---|---|
| Top | Description | ||||
#include <gio.h>
GIOExtension;
GIOExtensionPoint;
const char * g_io_extension_get_name (GIOExtension *extension);
gint g_io_extension_get_priority (GIOExtension *extension);
GType g_io_extension_get_type (GIOExtension *extension);
GIOExtension * g_io_extension_point_get_extension_by_name
(GIOExtensionPoint *extension_point,
const char *name);
GList * g_io_extension_point_get_extensions (GIOExtensionPoint *extension_point);
GType g_io_extension_point_get_required_type
(GIOExtensionPoint *extension_point);
GIOExtension * g_io_extension_point_implement (const char *extension_point_name,
GType type,
const char *extension_name,
gint priority);
GIOExtensionPoint * g_io_extension_point_lookup (const char *name);
GIOExtensionPoint * g_io_extension_point_register (const char *name);
void g_io_extension_point_set_required_type
(GIOExtensionPoint *extension_point,
GType type);
GTypeClass* g_io_extension_ref_class (GIOExtension *extension);
GIOExtensionPoint provides a mechanism for modules to extend the functionality of the library or application that loaded it in an organized fashion.
An extension point is identified by a name, and it may optionally
require that any implementation must by of a certain type (or derived
thereof). Use g_io_extension_point_register() to register an
extension point, and g_io_extension_point_set_required_type() to
set a required type.
A module can implement an extension point by specifying the GType
that implements the functionality. Additionally, each implementation
of an extension point has a name, and a priority. Use
g_io_extension_point_implement() to implement an extension point.
GIOExtensionPoint *ep;
/* Register an extension point */
ep = g_io_extension_point_register ("my-extension-point");
g_io_extension_point_set_required_type (ep, MY_TYPE_EXAMPLE);
/* Implement an extension point */
G_DEFINE_TYPE (MyExampleImpl, my_example_impl, MY_TYPE_EXAMPLE);
g_io_extension_point_implement ("my-extension-point",
my_example_impl_get_type (),
"my-example",
10);
It is up to the code that registered the extension point how it uses the implementations that have been associated with it. Depending on the use case, it may use all implementations, or only the one with the highest priority, or pick a specific one by name.
const char * g_io_extension_get_name (GIOExtension *extension);
Gets the name under which extension was registered.
Note that the same type may be registered as extension for multiple extension points, under different names.
|
a GIOExtension |
Returns : |
the name of extension.
|
gint g_io_extension_get_priority (GIOExtension *extension);
Gets the priority with which extension was registered.
|
a GIOExtension |
Returns : |
the priority of extension
|
GType g_io_extension_get_type (GIOExtension *extension);
Gets the type associated with extension.
|
a GIOExtension |
Returns : |
the type of extension
|
GIOExtension * g_io_extension_point_get_extension_by_name (GIOExtensionPoint *extension_point, const char *name);
Finds a GIOExtension for an extension point by name.
|
a GIOExtensionPoint |
|
the name of the extension to get |
Returns : |
the GIOExtension for extension_point that has the
given name, or NULL if there is no extension with that name
|
GList * g_io_extension_point_get_extensions (GIOExtensionPoint *extension_point);
Gets a list of all extensions that implement this extension point. The list is sorted by priority, beginning with the highest priority.
|
a GIOExtensionPoint |
Returns : |
a GList of GIOExtensions. The list is owned by GIO and should not be modified |
GType g_io_extension_point_get_required_type (GIOExtensionPoint *extension_point);
Gets the required type for extension_point.
|
a GIOExtensionPoint |
Returns : |
the GType that all implementations must have, or G_TYPE_INVALID if the extension point has no required type |
GIOExtension * g_io_extension_point_implement (const char *extension_point_name, GType type, const char *extension_name, gint priority);
Registers type as extension for the extension point with name
extension_point_name.
If type has already been registered as an extension for this
extension point, the existing GIOExtension object is returned.
|
the name of the extension point |
|
the GType to register as extension |
|
the name for the extension |
|
the priority for the extension |
Returns : |
a GIOExtension object for GType |
GIOExtensionPoint * g_io_extension_point_lookup (const char *name);
Looks up an existing extension point.
|
the name of the extension point |
Returns : |
the GIOExtensionPoint, or NULL if there is no
registered extension point with the given name
|
GIOExtensionPoint * g_io_extension_point_register (const char *name);
Registers an extension point.
|
The name of the extension point |
Returns : |
the new GIOExtensionPoint. This object is owned by GIO and should not be freed |
void g_io_extension_point_set_required_type
(GIOExtensionPoint *extension_point,
GType type);
Sets the required type for extension_point to type.
All implementations must henceforth have this type.
|
a GIOExtensionPoint |
|
the GType to require |
GTypeClass* g_io_extension_ref_class (GIOExtension *extension);
Gets a reference to the class for the type that is
associated with extension.
|
a GIOExtension |
Returns : |
the GTypeClass for the type of extension
|