BonoboSelector

BonoboSelector — a component selector widget

Functions

Properties

GValueArray * interfaces-required Write / Construct

Signals

void cancel Run Last
void ok Run Last

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── GtkWindow
                            ╰── GtkDialog
                                ╰── BonoboSelector

Implemented Interfaces

BonoboSelector implements AtkImplementorIface and GtkBuildable.

Description

This GnomeDialog allows the user to select a component implementing a set of interfaces. The easiest way to do this in your code is by using:

Example 10. Simple Bonobo/Control selection

1
2
3
4
5
6
7
8
{
    char *interfaces [] = { "IDL:Bonobo/Control:1.0", NULL };
    char *oaf_iid;
    oaf_iid = bonobo_selector_select_id (
        _("Please select a Control"), interfaces);
    g_warning ("You selected '%s'", oaf_iid);
    g_free (oaf_iid);
}


This will throw up a dialog containing all the available components implementing the IDL:Bonobo/Control:1.0 interface and list them for the user to select.

Functions

bonobo_selector_construct ()

GtkWidget *
bonobo_selector_construct (BonoboSelector *sel,
                           const gchar *title,
                           BonoboSelectorWidget *selector);

Don't use this ever - use construct-time properties instead. TODO: Remove from header when we are allowed to change the API. Constructs the innards of a bonobo selector window.

Parameters

sel

the selector to construct

 

title

the title for the window

 

selector

the component view widget to put inside it.

 

Returns

the constructed widget.


bonobo_selector_new ()

GtkWidget *
bonobo_selector_new (const gchar *title,
                     const gchar **interfaces_required);

Creates a new BonoboSelector widget. The title of the dialog is set to title , and the list of selectable servers is populated with those servers which support the interfaces specified in interfaces_required .

Parameters

title

A string which should go in the title of the BonoboSelector window.

 

interfaces_required

A NULL-terminated array of interfaces which a server must support in order to be listed in the selector. Defaults to "IDL:Bonobo/Embeddable:1.0" if no interfaces are listed.

 

Returns

A pointer to the newly-created BonoboSelector widget.


bonobo_selector_get_selected_id ()

gchar *
bonobo_selector_get_selected_id (BonoboSelector *sel);

Parameters

sel

A BonoboSelector widget.

 

Returns

A newly-allocated string containing the ID of the currently-selected CORBA server (i.e., the corba server whose name is highlighted in the list). The user of this function is responsible for freeing this. It will give an oaf iid back.


bonobo_selector_get_selected_name ()

gchar *
bonobo_selector_get_selected_name (BonoboSelector *sel);

Parameters

sel

A BonoboSelector widget.

 

Returns

A newly-allocated string containing the name of the currently-selected CORBA server (i.e., the corba server whose name is highlighted in the list). The user of this function is responsible for freeing this.


bonobo_selector_get_selected_description ()

gchar *
bonobo_selector_get_selected_description
                               (BonoboSelector *sel);

Parameters

sel

A BonoboSelector widget.

 

Returns

A newly-allocated string containing the description of the currently-selected CORBA server (i.e., the corba server whose name is highlighted in the list). The user of this function is responsible for freeing this.


bonobo_selector_select_id ()

gchar *
bonobo_selector_select_id (const gchar *title,
                           const gchar **interfaces_required);

Calls bonobo_selector_new() to create a new BonoboSelector widget with the specified paramters, title and interfaces_required . Then runs the dialog modally and allows the user to make a selection.

Parameters

title

The title to be used for the dialog.

 

interfaces_required

A list of required interfaces. See bonobo_selector_new().

 

Returns

The Oaf IID of the selected server, or NULL if no server is selected. The ID string has been allocated with g_strdup.

Types and Values

BonoboSelectorPrivate

typedef struct _BonoboSelectorPrivate BonoboSelectorPrivate;


struct BonoboSelector

struct BonoboSelector;


BonoboSelectorClass

typedef struct {
	GtkDialogClass parent_class;
	
	void (* ok) (BonoboSelector *sel);
	void (* cancel) (BonoboSelector *sel);

	gpointer dummy[2];
} BonoboSelectorClass;

Property Details

The “interfaces-required” property

  “interfaces-required”      GValueArray *

A NULL-terminated array of interfaces which a server must support in order to be listed in the selector. Defaults to "IDL:Bonobo/Embeddable:1.0" if no interfaces are listed.

Flags: Write / Construct

Signal Details

The “cancel” signal

void
user_function (BonoboSelector *bonoboselector,
               gpointer        user_data)

Parameters

bonoboselector

the object which received the signal.

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last


The “ok” signal

void
user_function (BonoboSelector *bonoboselector,
               gpointer        user_data)

Parameters

bonoboselector

the object which received the signal.

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last