|  |  |  | GNOME Dictionary Library Reference Manual |  | 
|---|---|---|---|---|
                    GdictStrategyChooser;
                    GdictStrategyChooserClass;
GtkWidget*          gdict_strategy_chooser_new          (void);
GtkWidget*          gdict_strategy_chooser_new_with_context
                                                        (GdictContext *context);
GdictContext*       gdict_strategy_chooser_get_context  (GdictStrategyChooser *chooser);
void                gdict_strategy_chooser_set_context  (GdictStrategyChooser *chooser,
                                                         GdictContext *context);
gchar**             gdict_strategy_chooser_get_strategies
                                                        (GdictStrategyChooser *chooser,
                                                         gsize *length);
gboolean            gdict_strategy_chooser_has_strategy (GdictStrategyChooser *chooser,
                                                         const gchar *strategy);
GtkWidget*          gdict_strategy_chooser_add_button   (GdictStrategyChooser *chooser,
                                                         const gchar *button_text);
void                gdict_strategy_chooser_clear        (GdictStrategyChooser *chooser);
gint                gdict_strategy_chooser_count_strategies
                                                        (GdictStrategyChooser *chooser);
gchar*              gdict_strategy_chooser_get_current_strategy
                                                        (GdictStrategyChooser *chooser);
void                gdict_strategy_chooser_refresh      (GdictStrategyChooser *chooser);
gboolean            gdict_strategy_chooser_select_strategy
                                                        (GdictStrategyChooser *chooser,
                                                         const gchar *strat_name);
gboolean            gdict_strategy_chooser_set_current_strategy
                                                        (GdictStrategyChooser *chooser,
                                                         const gchar *strat_name);
gboolean            gdict_strategy_chooser_unselect_strategy
                                                        (GdictStrategyChooser *chooser,
                                                         const gchar *strat_name);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkVBox +----GdictStrategyChooser
Each GdictContext allows matching a word using a specific "matching strategy". The GdictStrategyChooser widget queries a GdictContext and displays the list of available matching strategies.
typedef struct {
  GtkVBoxClass parent_class;
  void (*strategy_activated) (GdictStrategyChooser *chooser,
		  	      const gchar          *name,
			      const gchar          *description);
  
  void (*_gdict_padding1) (void);
  void (*_gdict_padding2) (void);
  void (*_gdict_padding3) (void);
  void (*_gdict_padding4) (void);
  void (*_gdict_padding5) (void);
  void (*_gdict_padding6) (void);
} GdictStrategyChooserClass;
GtkWidget* gdict_strategy_chooser_new (void);
Creates a new GdictStrategyChooser. Use this widget to show a list
of matching strategies available on a dictionary source represented
by a GdictContext, set with gdict_strategy_chooser_set_context().
| Returns : | the newly created GdictStrategyChooser widget | 
Since 0.9
GtkWidget* gdict_strategy_chooser_new_with_context (GdictContext *context);
Creates a new GdictStrategyChooser widget, using context as the
representation of a dictionary source.
| 
 | a GdictContext | 
| Returns : | the newly created GdictStrategyChooser widget | 
Since 0.9
GdictContext* gdict_strategy_chooser_get_context (GdictStrategyChooser *chooser);
Retrieves the GdictContext used by chooser.
| 
 | a GdictStrategyChooser | 
| Returns : | a GdictContext | 
Since
void gdict_strategy_chooser_set_context (GdictStrategyChooser *chooser, GdictContext *context);
Sets the GdictContext to be used by chooser to retrieve the
list of matching strategies.
| 
 | a GdictStrategyChooser | 
| 
 | a GdictContext, or NULLto unset the context | 
Since 0.9
gchar** gdict_strategy_chooser_get_strategies (GdictStrategyChooser *chooser, gsize *length);
Retrieves the list of matching strategies available.
| 
 | a GdictStrategyChooser | 
| 
 | return location for the length of the returned string list | 
| Returns : | a string vector containing the names of the matching
  strategies. Use g_strfreev()to deallocate the memory when done | 
Since 0.9
gboolean gdict_strategy_chooser_has_strategy (GdictStrategyChooser *chooser, const gchar *strategy);
Checks whether strategy is available in the list of matching
strategies displayed by chooser.
| 
 | a GdictStrategyChooser | 
| 
 | a strategy name | 
| Returns : | TRUEif the strategy was found,FALSEotherwise | 
Since 0.9
GtkWidget* gdict_strategy_chooser_add_button (GdictStrategyChooser *chooser, const gchar *button_text);
Creates a new button and packs it into the GdictStrategyChooser "action area".
| 
 | a GdictStrategyChooser | 
| 
 | text of the button (can be a stock id) | 
| Returns : | the packed GtkButton | 
Since 0.10
void gdict_strategy_chooser_clear (GdictStrategyChooser *chooser);
Clears chooser.
| 
 | a GdictStrategyChooser | 
Since 0.10
gint gdict_strategy_chooser_count_strategies (GdictStrategyChooser *chooser);
Returns the number of strategies found.
| 
 | a GdictStrategyChooser | 
| Returns : | the number of strategies or -1 if case of error | 
Since
gchar* gdict_strategy_chooser_get_current_strategy (GdictStrategyChooser *chooser);
Retrieves the current matching strategy.
| 
 | a GdictStrategyChooser | 
| Returns : | a newly allocated string containing the name of the current matching strategy | 
Since 0.10
void gdict_strategy_chooser_refresh (GdictStrategyChooser *chooser);
Reloads the list of available strategies.
| 
 | a GdictStrategyChooser | 
Since 0.10
gboolean gdict_strategy_chooser_select_strategy (GdictStrategyChooser *chooser, const gchar *strat_name);
Selects strat_name, if available.
| 
 | a GdictStrategyChooser | 
| 
 | the name of the strategy to select | 
| Returns : | TRUEif the matching strategy was found and selected | 
Since 0.10
gboolean gdict_strategy_chooser_set_current_strategy (GdictStrategyChooser *chooser, const gchar *strat_name);
Sets strat_name as the current matching strategy.
| 
 | a GdictStrategyChooser | 
| 
 | the name of the matching strategy | 
| Returns : | TRUEif the matching strategy was found | 
Since 0.10
gboolean gdict_strategy_chooser_unselect_strategy (GdictStrategyChooser *chooser, const gchar *strat_name);
Unselects strat_name from the list.
| 
 | a GdictStrategyChooser | 
| 
 | the name of the strategy to unselect | 
| Returns : | TRUEif the matching strategy was found and successfully
  unselected | 
Since 0.10
"strategy-activated" signalvoid user_function (GdictStrategyChooser *chooser, gchar *name, gchar *description, gpointer user_data) : Run Last
The ::strategy-activated signal is emitted each time the user
activates a strategy in the chooser, either by double click or
using the keyboard.
| 
 | the widget that received the signal | 
| 
 | the name of the activated strategy | 
| 
 | the description of the activate strategy | 
| 
 | user data set when the signal handler was connected. |