![]() |
![]() |
![]() |
MATE Dictionary Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
GtkWidget * gdict_source_chooser_new (void
); GtkWidget * gdict_source_chooser_new_with_loader (GdictSourceLoader *loader
); void gdict_source_chooser_set_loader (GdictSourceChooser *chooser
,GdictSourceLoader *loader
); GdictSourceLoader * gdict_source_chooser_get_loader (GdictSourceChooser *chooser
); gboolean gdict_source_chooser_select_source (GdictSourceChooser *chooser
,const gchar *source_name
); gboolean gdict_source_chooser_unselect_source (GdictSourceChooser *chooser
,const gchar *source_name
); gboolean gdict_source_chooser_set_current_source (GdictSourceChooser *chooser
,const gchar *source_name
); gchar * gdict_source_chooser_get_current_source (GdictSourceChooser *chooser
); gchar ** gdict_source_chooser_get_sources (GdictSourceChooser *chooser
,gsize *length
); gint gdict_source_chooser_count_sources (GdictSourceChooser *chooser
); gboolean gdict_source_chooser_has_source (GdictSourceChooser *chooser
,const gchar *source_name
); void gdict_source_chooser_refresh (GdictSourceChooser *chooser
); GtkWidget * gdict_source_chooser_add_button (GdictSourceChooser *chooser
,const gchar *button_text
);
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.
Returns : |
the newly created GdictSourceChooser widget. |
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.
|
a GdictSourceLoader |
Returns : |
the newly created GdictSourceChooser widget. |
Since 0.12
void gdict_source_chooser_set_loader (GdictSourceChooser *chooser
,GdictSourceLoader *loader
);
Sets the GdictSourceLoader to be used by the source chooser widget.
|
a GdictSourceChooser |
|
a GdictSourceLoader or NULL to unset it |
Since 0.12
GdictSourceLoader * gdict_source_chooser_get_loader (GdictSourceChooser *chooser
);
Retrieves the GdictSourceLoader used by chooser
.
|
a GdictSourceChooser |
Returns : |
a GdictSourceLoader or NULL is none is set |
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.
|
a GdictSourceChooser |
|
the name of a dictionary source |
Returns : |
TRUE if the source was found and selected |
Since 0.12
gboolean gdict_source_chooser_unselect_source (GdictSourceChooser *chooser
,const gchar *source_name
);
Unselects source_name
inside chooser
.
|
a GdictSourceChooser |
|
the name of a dictionary source |
Returns : |
TRUE if the source was found and unselected |
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.
|
a GdictSourceChooser |
|
the name of a dictionary source |
Returns : |
TRUE if the source was found |
Since 0.12
gchar * gdict_source_chooser_get_current_source
(GdictSourceChooser *chooser
);
Retrieves the currently selected source.
|
a GdictSourceChooser |
Returns : |
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 GdictSouceChooser |
|
return location for the length of the returned vector |
Returns : |
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.
|
a GdictSourceChooser |
Returns : |
the number of available sources, or -1 if no GdictSourceLoader has been set |
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
.
|
a GdictSourceChooser |
|
the name of a dictionary source |
Returns : |
TRUE if the dictionary source was found |
Since 0.12
void gdict_source_chooser_refresh (GdictSourceChooser *chooser
);
Forces a refresh on the contents of the source chooser widget
|
a GdictSourceChooser |
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.
|
a GdictSourceChooser |
|
text of the button |
Returns : |
the newly packed button. |
Since 0.12