BonoboControlFrame
An implementation of the container's frame containing a Control
The BonoboControlFrame object is used to embed a Control. Most
people will want to use #BonoboWidget instead of the control frame
since it provides lots of nice auxiliary features to make embedding
easy.
The Bonobo::ControlFrame interface
The control frame is coupled to an embedded control and is used
to allow the Control to communicate with its environment, particuarly
getting the #BonoboUIContainer for merging its menu / toolbar
UI elements.
A nice use of a BonoboControlFrame
BonoboWidget *
bonobo_widget_construct_control_from_objref (BonoboWidget *bw,
Bonobo_Control control,
Bonobo_UIContainer uic)
{
GtkWidget *control_frame_widget;
/*
* Create a local ControlFrame for it.
*/
bw->priv->control_frame = bonobo_control_frame_new (uic);
bonobo_control_frame_bind_to_control (bw->priv->control_frame, control);
...
bonobo_control_frame_set_autoactivate (bw->priv->control_frame, TRUE);
/*
* Grab the actual widget which visually contains the remote
* Control. This is a GtkSocket, in reality.
*/
control_frame_widget = bonobo_control_frame_get_widget (bw->priv->control_frame);
/*
* Now stick it into this BonoboWidget.
*/
gtk_container_add (GTK_CONTAINER (bw),
control_frame_widget);
/*
* Always remember to show the widget before reporting bugs.
*/
gtk_widget_show (control_frame_widget);
if (uic != CORBA_OBJECT_NIL)
bw->priv->uic = bonobo_object_dup_ref (uic, NULL);
return bw;
}
#BonoboWidget, bonobo_widget_new ()
@bonobocontrolframe: the object which received the signal.
@arg1:
@arg2:
@bonobocontrolframe: the object which received the signal.
@arg1:
@parent_class:
@epv:
@dummy:
@activated:
@activate_uri:
@control_frame:
@ui_container:
@ev:
@Returns:
@ui_container:
@Returns:
@frame:
@Returns:
@control_frame:
@uic:
@ev:
@control_frame:
@control_frame:
@control_frame:
@autoactivate:
@control_frame:
@Returns:
@control_frame:
@opt_ev:
@Returns:
@control_frame:
@propbag:
@control_frame:
@Returns:
@control_frame:
@state:
@control_frame:
@autostate:
@control_frame:
@Returns:
@control_frame:
@control:
@opt_ev:
@control_frame:
@Returns:
@control_frame:
@Returns:
@control_frame:
@opt_ev:
@Returns: