BonoboControl
An implementation of the control interface for GtkWidgets
The BonoboControl object implements the CORBA interface for
handling remote embeddable components. A Control is a light
weight, single view, arbitrarily complex 'widget'. Controls
typicaly expose much of their functionality through a
property bag.
The Bonobo::Control interface
A BonoboControl provides the server ( or component ) side
implementation of a Control. The client that uses this
control will probably use a #BonoboWidget to use the control
in their program.
If you want to expose your widget as a control it is very simple
CORBA-ifying your GtkWidget
BonoboControl *control;
GtkWidget *widget;
Bonobo_Unknown corba_object;
widget = make_my_widget ();
gtk_widget_show (widget);
control = bonobo_control_new (widget);
corba_object = BONOBO_OBJREF (control);
The corba_object can then be passed off down the wire to anyone
and the control popped into a #BonoboWidget or #BonoboControlFrame
at the other end. Here is an even less useful example
A pretty useless Control
GtkWidget *widget;
widget = gtk_button_new_with_label ("My Control");
gtk_widget_show (widget);
return bonobo_control_new (widget);
If you learn only one thing from this example, it should be that
you need to do a gtk_widget_show on your control. It is not
sufficient to do a gtk_widget_show_all on the top level of the
client side, since this will not ( and should not ) propagate
over to the Control.
One final thing worth thinking about is activation. When a control
is embedded inside a #BonoboControlFrame, it is initialy inactive.
In order for the control to recieve interactive input it is neccessary
to use bonobo_control_frame_activate. This signals to the control
that it is activated, at which point the Control should merge any
UI elements it has with the associated #BonoboUIComponent. This
needs to be done every time the control is activated.
#BonoboWidget, bonobo_widget_new()
@bonobocontrol: the object which received the signal.
@arg1:
@bonobocontrol: the object which received the signal.
@bonobocontrol: the object which received the signal.
@bonobocontrol: the object which received the signal.
@parent_class:
@epv:
@dummy:
@plug_created:
@disconnected:
@set_frame:
@activate:
@widget:
@Returns:
@control:
@Returns:
@control:
@automerge:
@control:
@Returns:
@control:
@opt_ev:
@first_prop:
@Varargs:
@control:
@opt_ev:
@first_prop:
@Varargs:
@control:
@window:
@opt_ev:
@control:
@window:
@opt_ev:
@control:
@widget:
@Returns:
@control:
@Returns:
@control:
@component:
@control:
@opt_ev:
@Returns:
@control:
@control_frame:
@opt_ev:
@control:
@opt_ev:
@Returns:
@control:
@pb:
@opt_ev:
@control:
@Returns:
@control:
@opt_ev:
@Returns:
@control:
@activated:
@opt_ev:
@x11_id:
@Returns:
@id:
@Returns:
@a:
@Returns:
@control:
@Returns:
@control:
@Returns:
@control:
@ui_container:
@control:
@button:
@activate_time:
@Returns:
@control:
@parent_menu_shell:
@parent_menu_item:
@func:
@data:
@button:
@activate_time:
@Returns:
@Param1:
@all_dead_callback:
@control:
@Returns: