bonobo-moniker-util
Object activation and construction through monikers.
The moniker utility functions provide two sets of functions:
Helper functions for constructing and resolving monikers,
and a simple get_object method that constructs and resolves
against an interface in a single pass. Also, asynchronous
versions of these methods are provided using the #BonoboAsync
code.
Helper functions for the implementation of new custom
monikers are also provided here, along with a lot of the
grunt code neccessary for moniker implementation, particularly
constructing the chained list of sub-monikers that comprises
a complex moniker.
The most useful function to get a feel for what monikers can do
is the bonobo_get_object method. This is
used to create a moniker and resolve it against a given interface
like this:
GetObject example
GtkWidget *
moniker_resolve_demo (void)
{
Bonobo_Control control;
CORBA_Environment ev;
CORBA_exception_init (&ev);
control = bonobo_get_object ("file:/demo/a.jpeg",
"Bonobo/Control", NULL);
if (control == CORBA_OBJECT_NIL)
g_error ("Failed to get object file:/demo/a.jpeg");
return bonobo_widget_new_control (control);
}
This also makes a control out of the widget.
It is worth noting that when resolving monikers a contracted
version of the interface name may be used, ommitting the 'IDL:'
prefix and / or the ':0' suffix.
@name:
@interface_name:
@opt_ev:
@Returns:
@name:
@opt_ev:
@Returns:
@moniker:
@opt_ev:
@Returns:
@moniker:
@interface_name:
@opt_ev:
@Returns:
@moniker:
@name:
@opt_ev:
@Returns:
Callback function, invoked when bonobo_get_object_async() completes its work.
@object: the newly-activated object, or %CORBA_OBJECT_NIL if an exception occurred
@ev: CORBA environment that may contain an exception if an activation error occurred
@user_data: user data
@name:
@interface_name:
@ev:
@cb:
@user_data:
@name:
@ev:
@cb:
@user_data:
@moniker:
@options:
@interface_name:
@ev:
@cb:
@user_data:
@moniker:
@interface_name:
@ev:
@cb:
@user_data:
@moniker:
@opt_ev:
@Returns:
@object:
@requested_interface:
@ev:
@Returns:
@name:
@plen:
@Returns:
@str:
@min_idx:
@Returns:
@string:
@offset:
@Returns:
@string:
@num_chars:
@Returns:
@oafiid:
@url:
@mime_type:
@object:
@ev:
@oafiid:
@url:
@ev:
@oafiid:
@url:
@ev:
@Returns: