Top | ![]() |
![]() |
![]() |
![]() |
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkBox ╰── GdictSourceChooser
GdictSourceChooser is a widget that shows the list of available dictionary sources using a GdictSourceLoader instance as a model. It can be used to allow choosing the current dictionary source.
GdictSourceChooser is available since Gdict 0.12.
GtkWidget *
gdict_source_chooser_new (void
);
Creates a new GdictSourceChooser widget. This widget can be used to display the list of available dictionary sources.
Since: 0.12
GtkWidget *
gdict_source_chooser_new_with_loader (GdictSourceLoader *loader
);
Creates a new GdictSourceChooser widget and sets loader
as the
GdictSourceLoader object to be used to retrieve the list of
available dictionary sources.
Since: 0.12
void gdict_source_chooser_set_loader (GdictSourceChooser *chooser
,GdictSourceLoader *loader
);
Sets the GdictSourceLoader to be used by the source chooser widget.
Since: 0.12
GdictSourceLoader *
gdict_source_chooser_get_loader (GdictSourceChooser *chooser
);
Retrieves the GdictSourceLoader used by chooser
.
Since: 0.12
gboolean gdict_source_chooser_select_source (GdictSourceChooser *chooser
,const gchar *source_name
);
Selects the dictionary source named source_name
inside chooser
.
The selection is moved but the row containing the dictionary source
is not activated.
Since: 0.12
gboolean gdict_source_chooser_unselect_source (GdictSourceChooser *chooser
,const gchar *source_name
);
Unselects source_name
inside chooser
.
Since: 0.12
gboolean gdict_source_chooser_set_current_source (GdictSourceChooser *chooser
,const gchar *source_name
);
Sets the current dictionary source named source_name
. The row
of the source, if found, will be selected and activated.
Since: 0.12
gchar *
gdict_source_chooser_get_current_source
(GdictSourceChooser *chooser
);
Retrieves the currently selected source.
a newly allocated string containing the name of
the currently selected source. Use g_free()
when done using it
Since: 0.12
gchar ** gdict_source_chooser_get_sources (GdictSourceChooser *chooser
,gsize *length
);
Retrieves the names of the available dictionary sources.
a newly allocated, NULL
terminated string vector
containing the names of the available sources. Use g_strfreev()
when done using it.
Since: 0.12
gint
gdict_source_chooser_count_sources (GdictSourceChooser *chooser
);
Retrieve the number of available dictionary sources.
Since: 0.12
gboolean gdict_source_chooser_has_source (GdictSourceChooser *chooser
,const gchar *source_name
);
Checks whether chooser
has a dictionary source named source_name
.
Since: 0.12
void
gdict_source_chooser_refresh (GdictSourceChooser *chooser
);
Forces a refresh on the contents of the source chooser widget
Since: 0.12
GtkWidget * gdict_source_chooser_add_button (GdictSourceChooser *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.
Since: 0.12
“count”
property“count” gint
The number of available dictionary sources, or -1 if no GdictSourceLoader is set.
Flags: Read
Allowed values: >= -1
Default value: -1
Since: 0.12
“loader”
property“loader” GdictSourceLoader *
The GdictSourceLoader used to retrieve the list of available dictionary sources.
Flags: Read / Write / Construct
Since: 0.12
“selection-changed”
signalvoid user_function (GdictSourceChooser *chooser, gpointer user_data)
The ::selection-changed signal is emitted each time the selection inside the source chooser widget has been changed.
chooser |
the GdictSourceChooser that received the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 0.12
“source-activated”
signalvoid user_function (GdictSourceChooser *chooser, gchar *source_name, GdictSource *source, gpointer user_data)
The ::source-activated signal is emitted each time the user activates a row in the source chooser widget, either by double clicking on it or by a keyboard event.
chooser |
the GdictSourceChooser that received the signal |
|
source_name |
the name of the activated source |
|
source |
the activated GdictSource |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 0.12