bonobo-widget

bonobo-widget

Functions

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── BonoboWidget

Implemented Interfaces

BonoboWidget implements AtkImplementorIface and GtkBuildable.

Description

Functions

bonobo_widget_get_objref ()

Bonobo_Unknown
bonobo_widget_get_objref (BonoboWidget *bw);

bonobo_widget_new_control ()

GtkWidget *
bonobo_widget_new_control (const char *moniker,
                           Bonobo_UIContainer uic);

This function is a simple wrapper for easily embedding controls into applications. It will launch the component identified by id and will return it as a GtkWidget.

Parameters

moniker

A Moniker describing the object to be activated

 

uic

Bonobo_UIContainer for the launched object or CORBA_OBJECT_NIL if there is no need of menu / toolbar merging.

 

Returns

A GtkWidget that is bound to the Bonobo Control.


bonobo_widget_new_control_from_objref ()

GtkWidget *
bonobo_widget_new_control_from_objref (Bonobo_Control control,
                                       Bonobo_UIContainer uic);

This function is a simple wrapper for easily embedding controls into applications. This function is used when you have already a CORBA object reference to an IDL:Bonobo/Control:1.0 (the control ) argument.

Parameters

control

A CORBA Object reference to an IDL:Bonobo/Control:1.0

 

uic

Bonobo_UIContainer for the launched object or CORBA_OBJECT_NIL if there is no need of menu / toolbar merging.

 

Returns

the control wrapped as a GtkWidget.


bonobo_widget_get_control_frame ()

BonoboControlFrame *
bonobo_widget_get_control_frame (BonoboWidget *bw);

Every IDL:Bonobo/Control:1.0 needs to be placed inside an IDL:Bonobo/ControlFrame:1.0. This returns the BonoboControlFrame object that wraps the Control in the bonobo_widget .

Parameters

bonobo_widget

a Bonobo Widget returned by one of the bonobo_widget_new() functions.

 

Returns

The BonoboControlFrame associated with the bonobo_widget


bonobo_widget_get_ui_container ()

Bonobo_UIContainer
bonobo_widget_get_ui_container (BonoboWidget *bw);

Parameters

bonobo_widget

the BonoboWidget to query.

 

Returns

the CORBA object reference to the Bonobo_UIContainer associated with the bonobo_widget .


BonoboWidgetAsyncFn ()

void
(*BonoboWidgetAsyncFn) (BonoboWidget *widget,
                        CORBA_Environment *ev,
                        gpointer user_data);

bonobo_widget_new_control_async ()

GtkWidget *
bonobo_widget_new_control_async (const char *moniker,
                                 Bonobo_UIContainer uic,
                                 BonoboWidgetAsyncFn fn,
                                 gpointer user_data);

This method creates a widget, returns it to the user, and asynchronously activates a control to insert into the widget.

Parameters

moniker

A Moniker describing the object to be activated

 

uic

Bonobo_UIContainer for the launched object or CORBA_OBJECT_NIL if there is no need of menu / toolbar merging.

 

fn

a callback function called when the activation has happend

 

user_data

user data to be passed back to the callback.

 

Returns

a (temporarily) empty Widget to be filled with the control later


bonobo_widget_construct_control_from_objref ()

BonoboWidget *
bonobo_widget_construct_control_from_objref
                               (BonoboWidget *bw,
                                Bonobo_Control control,
                                Bonobo_UIContainer uic,
                                CORBA_Environment *ev);

This is a constructor function. Only usable for wrapping and derivation of new objects. For normal use, please refer to bonobo_widget_new_control_from_objref.

Parameters

bw

A BonoboWidget to construct

 

control

A CORBA Object reference to an IDL:Bonobo/Control:1.0

 

uic

Bonobo_UIContainer for the launched object or CORBA_OBJECT_NIL if there is no need of menu / toolbar merging.

 

ev

a CORBA exception environment

 

Returns

A BonoboWidget (the bw )


bonobo_widget_construct_control ()

BonoboWidget *
bonobo_widget_construct_control (BonoboWidget *bw,
                                 const char *moniker,
                                 Bonobo_UIContainer uic,
                                 CORBA_Environment *ev);

This is a constructor function. Only usable for wrapping and derivation of new objects. For normal use, please refer to bonobo_widget_new_control.

This function will unref the passed in bw in case it cannot launch the component and return NULL in such a case. Otherwise it returns the bw itself.

Parameters

bw

A BonoboWidget to construct

 

moniker

A Moniker describing the object to be activated

 

uic

Bonobo_UIContainer for the launched object or CORBA_OBJECT_NIL if there is no need of menu / toolbar merging.

 

ev

a CORBA exception environment

 

Returns

A BonoboWidget or NULL


bonobo_widget_set_property ()

void
bonobo_widget_set_property (BonoboWidget *control,
                            const char *first_prop,
                            ...);

This is a utility function used to set a number of properties in the Bonobo Control in control .

This function takes a variable list of arguments that must be NULL terminated. Arguments come in tuples: a string (for the argument name) and the data type that is to be transfered. The implementation of the actual setting of the PropertyBag values is done by the bonobo_property_bag_client_setv() function).

This only works for BonoboWidgets that represent controls (ie, that were returned by bonobo_widget_new_control_from_objref() or bonobo_widget_new_control().

Parameters

control

A BonoboWidget that represents an IDL:Bonobo/Control:1.0

 

first_prop

first property name to set.

 

bonobo_widget_get_property ()

void
bonobo_widget_get_property (BonoboWidget *control,
                            const char *first_prop,
                            ...);

This is a utility function used to get a number of properties in the Bonobo Control in control .

This function takes a variable list of arguments that must be NULL terminated. Arguments come in tuples: a string (for the argument name) and a pointer where the data will be stored. The implementation of the actual setting of the PropertyBag values is done by the bonobo_property_bag_client_setv() function).

This only works for BonoboWidgets that represent controls (ie, that were returned by bonobo_widget_new_control_from_objref() or bonobo_widget_new_control().

Parameters

control

A BonoboWidget that represents an IDL:Bonobo/Control:1.0

 

first_prop

first property name to set.

 

bonobo_widget_get_uih()

#define bonobo_widget_get_uih(w) bonobo_widget_get_ui_container (w)

Types and Values

struct BonoboWidget

struct BonoboWidget;

BonoboWidgetPrivate

typedef struct _BonoboWidgetPrivate BonoboWidgetPrivate;

BonoboWidgetClass

typedef struct {
	GtkBinClass	 bin_class;

	gpointer dummy[4];
} BonoboWidgetClass;