BonoboClientSite
Container side object embedding server.
The BonoboClientSite implements the
Bonobo::ClientSite CORBA interface. It acts
as the container-side contact for
BonoboEmbeddable objects.
For each object embedded in your application, you should create a
BonoboClientSite object.
Once you have a handle on a remote object that implements the
Bonobo::Embeddable interface (typically
returned by bonobo_object_activate() or
bonobo_get_object () or wrapper with
bonobo_object_client_from_corba ()) of type
BonoboObjectClient), you will have to bind
this object to the BonoboClientSite using the
bonobo_client_site_bind_embeddable (). Once this is done, you will
be able to request a #BonoboView on the #BonoboClientSite.
The #BonoboClientSite object also provides access to the remote
BonoboEmbeddable object's verb list.
Sample usage
This demostrates the use of the #BonoboClientSite object. This
launches the object specified, creates a #BonoboClientSite,
then requests a new #BonoboViewFrame and finally it returns the
widget that represents that component.
GtkWidget *
create_widget_from_component (BonoboContainer *container, const char *id)
{
BonoboObjectClient *server;
BonoboClientSite *client_site;
BonoboViewFrame *view_frame;
/*
* Launch the requested component
*/
server = bonobo_object_activate (id, 0);
if (!server){
printf ("Could not activate the server");
return NULL;
}
client_site = bonobo_client_site_new (app->container);
/*
* Add this client site to the container
*/
bonobo_container_add (container, BONOBO_OBJECT (client_site));
/*
* Bind the component to the client site
*/
bonobo_client_site_bind_embeddable (client_site, server);
/*
* Create a new BonoboView, and then get a GtkWidget
*/
view_frame = bonobo_client_site_embeddable_new_view (client_site);
/*
* Get the widget for this view.
*/
return bonobo_view_frame_get_wrapper (view_frame);
}
#BonoboEmbeddable, #BonoboContainer, #BonoboObjectClient, #BonoboViewFrame
@container:
@Returns:
@client_site:
@container:
@Returns:
@corba_client_site:
@client_site:
@object:
@Returns:
@client_site:
@Returns:
@client_site:
@Returns:
@client_site:
@uic:
@visible_cover:
@active_view:
@Returns:
@uih:
@client_site:
@uic:
@Returns:
@uih:
@client_site:
@uic:
@group:
@Returns:
@client_site:
@Returns:
@verb_list:
@bonoboclientsite: the object which received the signal.
@arg1:
@bonoboclientsite: the object which received the signal.
@arg1: