BonoboSelector

Name

BonoboSelector -- a component selector widget

Synopsis



typedef     BonoboSelector;
typedef     BonoboSelectorClass;
GtkWidget*  bonobo_selector_new             (const gchar *title,
                                             const gchar **interfaces_required);
GtkWidget*  bonobo_selector_construct       (BonoboSelector *sel,
                                             const gchar *title,
                                             BonoboSelectorWidget *selector);
gchar*      bonobo_selector_get_selected_id (BonoboSelector *sel);
gchar*      bonobo_selector_get_selected_name
                                            (BonoboSelector *sel);
gchar*      bonobo_selector_get_selected_description
                                            (BonoboSelector *sel);
gchar*      bonobo_selector_select_id       (const gchar *title,
                                             const gchar **interfaces_required);

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 1. Simple Bonobo/Control selection

{
	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.

Details

BonoboSelector

typedef struct {
	GnomeDialog dialog;

	BonoboSelectorPrivate *priv;
} BonoboSelector;


BonoboSelectorClass

typedef struct {
	GnomeDialogClass parent_class;
	
	void (* ok)	(BonoboSelector *sel);
	void (* cancel)	(BonoboSelector *sel);
} BonoboSelectorClass;


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.


bonobo_selector_construct ()

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

Constructs the innards of a bonobo selector window.


bonobo_selector_get_selected_id ()

gchar*      bonobo_selector_get_selected_id (BonoboSelector *sel);


bonobo_selector_get_selected_name ()

gchar*      bonobo_selector_get_selected_name
                                            (BonoboSelector *sel);


bonobo_selector_get_selected_description ()

gchar*      bonobo_selector_get_selected_description
                                            (BonoboSelector *sel);


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.