|  |  |  | GNOME Dictionary Library Reference Manual |  | 
|---|---|---|---|---|
                    GdictDatabaseChooser;
                    GdictDatabaseChooserClass;
GtkWidget*          gdict_database_chooser_new          (void);
GtkWidget*          gdict_database_chooser_new_with_context
                                                        (GdictContext *context);
GdictContext*       gdict_database_chooser_get_context  (GdictDatabaseChooser *chooser);
void                gdict_database_chooser_set_context  (GdictDatabaseChooser *chooser,
                                                         GdictContext *context);
gchar**             gdict_database_chooser_get_databases
                                                        (GdictDatabaseChooser *chooser,
                                                         gsize *length);
gint                gdict_database_chooser_count_databases
                                                        (GdictDatabaseChooser *chooser);
gboolean            gdict_database_chooser_has_database (GdictDatabaseChooser *chooser,
                                                         const gchar *database);
void                gdict_database_chooser_refresh      (GdictDatabaseChooser *chooser);
void                gdict_database_chooser_clear        (GdictDatabaseChooser *chooser);
GtkWidget*          gdict_database_chooser_add_button   (GdictDatabaseChooser *chooser,
                                                         const gchar *button_text);
gchar*              gdict_database_chooser_get_current_database
                                                        (GdictDatabaseChooser *chooser);
gboolean            gdict_database_chooser_select_database
                                                        (GdictDatabaseChooser *chooser,
                                                         const gchar *db_name);
gboolean            gdict_database_chooser_set_current_database
                                                        (GdictDatabaseChooser *chooser,
                                                         const gchar *db_name);
gboolean            gdict_database_chooser_unselect_database
                                                        (GdictDatabaseChooser *chooser,
                                                         const gchar *db_name);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkVBox +----GdictDatabaseChooser
Each GdictContext has a list of databases, that is dictionaries that can be queried. GdictDatabaseChooser is a widget that queries a given GdictContext and displays the list of available databases.
GdictDatabaseChooser is available since Gdict 0.10
typedef struct {
  void (*database_activated) (GdictDatabaseChooser *chooser,
		  	      const gchar          *name,
			      const gchar          *description);
  void (*selection_changed)  (GdictDatabaseChooser *chooser);
} GdictDatabaseChooserClass;
GtkWidget* gdict_database_chooser_new (void);
Creates a new GdictDatabaseChooser widget. A Database chooser widget
can be used to display the list of available databases on a dictionary
source using the GdictContext representing it. After creation, the
GdictContext can be set using gdict_database_chooser_set_context().
| Returns : | the newly created GdictDatabaseChooser widget. | 
Since 0.10
GtkWidget* gdict_database_chooser_new_with_context (GdictContext *context);
Creates a new GdictDatabaseChooser, using context as the representation
of the dictionary source to query for the list of available databases.
| 
 | a GdictContext | 
| Returns : | the newly created GdictDatabaseChooser widget. | 
Since 0.10
GdictContext* gdict_database_chooser_get_context (GdictDatabaseChooser *chooser);
Retrieves the GdictContext used by chooser.
| 
 | a GdictDatabaseChooser | 
| Returns : | a GdictContext or NULL | 
Since 0.10
void gdict_database_chooser_set_context (GdictDatabaseChooser *chooser, GdictContext *context);
Sets the GdictContext to be used to query a dictionary source for the list of available databases.
| 
 | a GdictDatabaseChooser | 
| 
 | a GdictContext | 
Since 0.10
gchar** gdict_database_chooser_get_databases (GdictDatabaseChooser *chooser, gsize *length);
Gets the list of available database names.
| 
 | a GdictDatabaseChooser | 
| 
 | return location for the length of the returned vector | 
| Returns : | a newly allocated, NULLterminated string vector
  containing database names. Useg_strfreev()to deallocate it. | 
Since 0.10
gint gdict_database_chooser_count_databases (GdictDatabaseChooser *chooser);
Returns the number of databases found.
| 
 | a GdictDatabaseChooser | 
| Returns : | the number of databases or -1 if no context is set | 
Since 0.10
gboolean gdict_database_chooser_has_database (GdictDatabaseChooser *chooser, const gchar *database);
Checks whether the chooser displays database
| 
 | a GdictDatabaseChooser | 
| 
 | the name of a database | 
| Returns : | TRUEif the search database name is present | 
Since 0.10
void gdict_database_chooser_refresh (GdictDatabaseChooser *chooser);
Reloads the list of available databases.
| 
 | a GdictDatabaseChooser | 
Since 0.10
void gdict_database_chooser_clear (GdictDatabaseChooser *chooser);
Clears chooser.
| 
 | a GdictDatabaseChooser | 
Since 0.10
GtkWidget* gdict_database_chooser_add_button (GdictDatabaseChooser *chooser, const gchar *button_text);
Adds a GtkButton with button_text to the button area on
the bottom of chooser. The button_text can also be a
stock ID.
| 
 | a GdictDatabase | 
| 
 | text of the button | 
| Returns : | the newly packed button. | 
Since 0.10
gchar* gdict_database_chooser_get_current_database (GdictDatabaseChooser *chooser);
Retrieves the name of the currently selected database inside chooser
| 
 | a GdictDatabaseChooser | 
| Returns : | the name of the selected database. Use g_free()on the
  returned string when done using it | 
Since 0.10
gboolean gdict_database_chooser_select_database (GdictDatabaseChooser *chooser, const gchar *db_name);
Selects the database with db_name inside the chooser widget.
| 
 | a GdictDatabaseChooser | 
| 
 | name of the database to select | 
| Returns : | TRUEif the database was found and selected | 
Since 0.10
gboolean gdict_database_chooser_set_current_database (GdictDatabaseChooser *chooser, const gchar *db_name);
Sets db_name as the current database. This function will select
and activate the corresponding row, if the database is found.
| 
 | a GdictDatabaseChooser | 
| 
 | the name of the database | 
| Returns : | TRUEif the database was found and set | 
Since 0.10
gboolean gdict_database_chooser_unselect_database (GdictDatabaseChooser *chooser, const gchar *db_name);
Unselects the database db_name inside the chooser widget
| 
 | a GdictDatabaseChooser | 
| 
 | name of the database to unselect | 
| Returns : | TRUEif the database was found and unselected | 
Since 0.10
"context" property"context" GdictContext* : Read / Write / Construct
The GdictContext used to retrieve the list of available databases.
Since 0.10
"count" property"count" gint : Read
The number of displayed databases or, if no GdictContext is set, -1.
Allowed values: >= -1
Default value: -1
Since 0.12
"database-activated" signalvoid user_function (GdictDatabaseChooser *chooser, gchar *name, gchar *description, gpointer user_data) : Run Last
The ::database-activated signal is emitted each time the user activated a row in the database chooser widget, either by double clicking on it or by a keyboard event.
| 
 | the database chooser that received the signal | 
| 
 | the name of the activated database | 
| 
 | the description of the activated database | 
| 
 | user data set when the signal handler was connected. | 
Since 0.10
"selection-changed" signalvoid user_function (GdictDatabaseChooser *chooser, gpointer user_data) : Run Last
The ::selection-changed signal is emitted each time the selection inside the database chooser has been changed.
| 
 | the database chooser that received the signal | 
| 
 | user data set when the signal handler was connected. | 
Since 0.12