Copyright (C) 2000-2012 |
Whole document tree
BonoboClientSiteSynopsis
DescriptionThe 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. Example 1. 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.
DetailsBonoboClientSiteClass
bonobo_client_site_new ()
Container programs should provide a BonoboClientSite GTK object (ie, a Bonobo::ClientSite CORBA server) for each Embeddable which they embed. This is the contact end point for the remote Bonobo::Embeddable object. This routine creates a new BonoboClientSite. bonobo_client_site_construct ()
This initializes an object of type BonoboClientSite. See the description for bonobo_client_site_new() for more details. bonobo_client_site_bind_embeddable ()
This routine binds a remote Embeddable object to a local BonoboClientSite object. The idea is that there is always a one-to-one mapping between BonoboClientSites and BonoboEmbeddables. The Embeddable uses its BonoboClientSite to communicate with the container in which it is embedded. bonobo_client_site_get_embeddable ()
bonobo_client_site_get_container ()
bonobo_client_site_new_view_full ()
Creates a ViewFrame and asks the remote server_object (which must support the Bonobo::Embeddable interface) to provide a new view of its data. The remote server_object will construct a BonoboView object which corresponds to the new BonoboViewFrame returned by this function.
bonobo_client_site_new_view ()
The same as bonobo_client_site_new_view_full() with an inactive, visible cover. bonobo_client_site_new_item ()
|