## GnomeDbControlWidget

GnomeDbControlWidget — Bonobo control client side widget

##

# Synopsis

    struct      GnomeDbControlWidgetPrivate;
    GtkWidget*  gnome_db_control_widget_construct
                                                (GnomeDbControlWidget *wid,
                                                 const gchar *id,
                                                 Bonobo_UIContainer uic);
    GtkWidget*  gnome_db_control_widget_new     (const gchar *id,
                                                 Bonobo_UIContainer uic);
    GtkWidget*  gnome_db_control_widget_new_from_corba
                                                (Bonobo_Control control,
                                                 Bonobo_UIContainer uic);
    gboolean    gnome_db_control_widget_is_alive
                                                (GnomeDbControlWidget *wid);
    void        gnome_db_control_widget_activate
                                                (GnomeDbControlWidget *wid);
    void        gnome_db_control_widget_deactivate
                                                (GnomeDbControlWidget *wid);
    const gchar* gnome_db_control_widget_get_id (GnomeDbControlWidget *wid);
    Bonobo_Unknown gnome_db_control_widget_get_objref
                                                (GnomeDbControlWidget *wid);
    Bonobo_UIContainer gnome_db_control_widget_get_ui_container
                                                (GnomeDbControlWidget *wid);

## Description

## Details

### struct GnomeDbControlWidgetPrivate

    struct GnomeDbControlWidgetPrivate;

### gnome_db_control_widget_construct ()

    GtkWidget*  gnome_db_control_widget_construct
                                                (GnomeDbControlWidget *wid,
                                                 const gchar *id,
                                                 Bonobo_UIContainer uic);

`wid` : |
`id` : |
`uic` : |
Returns : |

### gnome_db_control_widget_new ()

    GtkWidget*  gnome_db_control_widget_new     (const gchar *id,
                                                 Bonobo_UIContainer uic);

Creates a new widget that loads the Bonobo control specified by the `id` parameter. The second argument, `uic`, is needed to associate a Bonobo container with the new control, so that menus and toolbars are merged. This is easily done by using a GnomeDbWindow for all your Bonobo container needs, and then use the gnome_db_window_get_ui_container to retrieve the Bonobo_UIContainer associated with the GnomeDbWindow widget.

`id` : | ID of the Bonobo control to be loaded
`uic` : | a reference to the Bonobo_UIContainer to use for the control
Returns : | a pointer to the newly-created widget

### gnome_db_control_widget_new_from_corba ()

    GtkWidget*  gnome_db_control_widget_new_from_corba
                                                (Bonobo_Control control,
                                                 Bonobo_UIContainer uic);

`control` : |
`uic` : |
Returns : |

### gnome_db_control_widget_is_alive ()

    gboolean    gnome_db_control_widget_is_alive
                                                (GnomeDbControlWidget *wid);

Pings the given GnomeDbControlWidget widget to see if the underlying CORBA server is still alive.

`wid` : | a GnomeDbControlWidget widget
Returns : | TRUE if alive, FALSE if dead.

### gnome_db_control_widget_activate ()

    void        gnome_db_control_widget_activate
                                                (GnomeDbControlWidget *wid);

Activates the given GnomeDbControlWidget widget. This means that the underlying control's menus and toolbars will be merged with the menus and toolbars of the container being used, generally a GnomeDbWindow widget.

`wid` : | a GnomeDbControlWidget widget

### gnome_db_control_widget_deactivate ()

    void        gnome_db_control_widget_deactivate
                                                (GnomeDbControlWidget *wid);

Deactivates the given GnomeDbControlWidget widget. This means that all of the control's menus and toolbars are removed from the container.

`wid` : | a GnomeDbControlWidget widget

### gnome_db_control_widget_get_id ()

    const gchar* gnome_db_control_widget_get_id (GnomeDbControlWidget *wid);

Returns the ID of the underlying control.

`wid` : | a GnomeDbControlWidget widget.
Returns : | the ID of the underlying control.

### gnome_db_control_widget_get_objref ()

    Bonobo_Unknown gnome_db_control_widget_get_objref
                                                (GnomeDbControlWidget *wid);

`wid` : |
Returns : |

### gnome_db_control_widget_get_ui_container ()

    Bonobo_UIContainer gnome_db_control_widget_get_ui_container
                                                (GnomeDbControlWidget *wid);

`wid` : |
Returns : |