Name
BonoboObjectClient -- Object activation routines
Synopsis
#define BONOBO_OBJECT_CLIENT_TYPE
#define BONOBO_OBJECT_CLIENT (o)
#define BONOBO_OBJECT_CLIENT_CLASS (k)
#define BONOBO_IS_OBJECT_CLIENT (o)
#define BONOBO_IS_OBJECT_CLIENT_CLASS (k)
typedef BonoboObjectClient;
typedef BonoboObjectClientClass;
void (*BonoboObjectClientAsyncCallback)
(BonoboObjectClient *o,
const char *error,
gpointer user_data);
BonoboObjectClient* bonobo_object_client_from_corba
(Bonobo_Unknown o);
BonoboObjectClient* bonobo_object_client_construct
(BonoboObjectClient *object_client,
CORBA_Object corba_object);
BonoboObjectClient* bonobo_object_activate (const char *iid,
gint oaf_flags);
void bonobo_object_activate_async (const char *iid,
gint oaf_flags,
BonoboObjectClientAsyncCallback callback,
gpointer user_data);
gboolean bonobo_object_client_has_interface
(BonoboObjectClient *object,
const char *interface_desc,
CORBA_Environment *opt_ev);
Bonobo_Unknown bonobo_object_client_query_interface
(BonoboObjectClient *object,
const char *interface_desc,
CORBA_Environment *opt_ev);
void bonobo_object_client_ref (BonoboObjectClient *object_client,
BonoboObject *opt_exception_obj);
void bonobo_object_client_unref (BonoboObjectClient *object_client,
BonoboObject *opt_exception_obj);
|
Description
The BonoboObjectClient object is used primarly to activate Bonobo
components (mainly by using gnome_object_activate()). The CORBA
object reference to the Bonobo object is wrapped in a BonoboObject.
The BonoboObjectClient object is also used to wrap an arbitrary
Bonobo::Unknown CORBA object reference into a BonoboObject (by using
gnome_object_client_from_corba()).
The main activation entry point is the gnome_object_activate()
function. This is a high-level routine that knows how to activate
components or activate and restore components. Internally
gnome_object_activate() checks whether its argument is a moniker_url
or a GOAD-ID and depending on this it invokes
gnome_object_activate_with_goad_id() or gnome_object_restore_from_url().
The gnome_object_activate_with_goad_id() routine basically uses
GNORBA's goad_server_activate_with_id() to launch the component ( or
launch the factory implementing the component and requesting from
the factory a new instance).
The gnome_object_restore_from_url() takes a textual moniker url
description (See BonoboMoniker) that represents a specific object
that is defined at least by a component and a url to restore its
state from. Optionally, you can specific a subobject to request
from the resulting object.
Details
BONOBO_OBJECT_CLIENT_TYPE
#define BONOBO_OBJECT_CLIENT_TYPE (bonobo_object_client_get_type ()) |
Returns the GtkType for the BonoboObjectClient object.
BONOBO_OBJECT_CLIENT()
#define BONOBO_OBJECT_CLIENT(o) (GTK_CHECK_CAST ((o), BONOBO_OBJECT_CLIENT_TYPE, BonoboObjectClient)) |
BONOBO_OBJECT_CLIENT_CLASS()
#define BONOBO_OBJECT_CLIENT_CLASS(k) (GTK_CHECK_CLASS_CAST((k), BONOBO_OBJECT_CLIENT_TYPE, BonoboObjectClientClass)) |
BONOBO_IS_OBJECT_CLIENT()
#define BONOBO_IS_OBJECT_CLIENT(o) (GTK_CHECK_TYPE ((o), BONOBO_OBJECT_CLIENT_TYPE)) |
BONOBO_IS_OBJECT_CLIENT_CLASS()
#define BONOBO_IS_OBJECT_CLIENT_CLASS(k) (GTK_CHECK_CLASS_TYPE ((k), BONOBO_OBJECT_CLIENT_TYPE)) |
BonoboObjectClient
typedef struct {
BonoboObject parent;
} BonoboObjectClient; |
BonoboObjectClientClass
typedef struct {
BonoboObjectClass parent_class;
} BonoboObjectClientClass; |
BonoboObjectClientAsyncCallback ()
void (*BonoboObjectClientAsyncCallback)
(BonoboObjectClient *o,
const char *error,
gpointer user_data); |
bonobo_object_client_from_corba ()
bonobo_object_client_construct ()
bonobo_object_activate ()
bonobo_object_activate_async ()
bonobo_object_client_has_interface ()
gboolean bonobo_object_client_has_interface
(BonoboObjectClient *object,
const char *interface_desc,
CORBA_Environment *opt_ev); |
bonobo_object_client_query_interface ()
Bonobo_Unknown bonobo_object_client_query_interface
(BonoboObjectClient *object,
const char *interface_desc,
CORBA_Environment *opt_ev); |
bonobo_object_client_ref ()
bonobo_object_client_unref ()