GdictStrategyChooser

GdictStrategyChooser — Display a list of matching strategies

Synopsis

                    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);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBox
                                 +----GtkVBox
                                       +----GdictStrategyChooser

Implemented Interfaces

GdictStrategyChooser implements AtkImplementorIface and GtkBuildable.

Properties

  "context"                  GdictContext*         : Read / Write / Construct

Signals

  "strategy-activated"                             : Run Last

Description

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.

Details

GdictStrategyChooser

typedef struct _GdictStrategyChooser GdictStrategyChooser;


GdictStrategyChooserClass

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;


gdict_strategy_chooser_new ()

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


gdict_strategy_chooser_new_with_context ()

GtkWidget*          gdict_strategy_chooser_new_with_context
                                                        (GdictContext *context);

Creates a new GdictStrategyChooser widget, using context as the representation of a dictionary source.

context :

a GdictContext

Returns :

the newly created GdictStrategyChooser widget

Since 0.9


gdict_strategy_chooser_get_context ()

GdictContext*       gdict_strategy_chooser_get_context  (GdictStrategyChooser *chooser);

Retrieves the GdictContext used by chooser.

chooser :

a GdictStrategyChooser

Returns :

a GdictContext

Since


gdict_strategy_chooser_set_context ()

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.

chooser :

a GdictStrategyChooser

context :

a GdictContext, or NULL to unset the context

Since 0.9


gdict_strategy_chooser_get_strategies ()

gchar**             gdict_strategy_chooser_get_strategies
                                                        (GdictStrategyChooser *chooser,
                                                         gsize *length);

Retrieves the list of matching strategies available.

chooser :

a GdictStrategyChooser

length :

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


gdict_strategy_chooser_has_strategy ()

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.

chooser :

a GdictStrategyChooser

strategy :

a strategy name

Returns :

TRUE if the strategy was found, FALSE otherwise

Since 0.9


gdict_strategy_chooser_add_button ()

GtkWidget*          gdict_strategy_chooser_add_button   (GdictStrategyChooser *chooser,
                                                         const gchar *button_text);

Creates a new button and packs it into the GdictStrategyChooser "action area".

chooser :

a GdictStrategyChooser

button_text :

text of the button (can be a stock id)

Returns :

the packed GtkButton

Since 0.10


gdict_strategy_chooser_clear ()

void                gdict_strategy_chooser_clear        (GdictStrategyChooser *chooser);

Clears chooser.

chooser :

a GdictStrategyChooser

Since 0.10


gdict_strategy_chooser_count_strategies ()

gint                gdict_strategy_chooser_count_strategies
                                                        (GdictStrategyChooser *chooser);

Returns the number of strategies found.

chooser :

a GdictStrategyChooser

Returns :

the number of strategies or -1 if case of error

Since


gdict_strategy_chooser_get_current_strategy ()

gchar*              gdict_strategy_chooser_get_current_strategy
                                                        (GdictStrategyChooser *chooser);

Retrieves the current matching strategy.

chooser :

a GdictStrategyChooser

Returns :

a newly allocated string containing the name of the current matching strategy

Since 0.10


gdict_strategy_chooser_refresh ()

void                gdict_strategy_chooser_refresh      (GdictStrategyChooser *chooser);

Reloads the list of available strategies.

chooser :

a GdictStrategyChooser

Since 0.10


gdict_strategy_chooser_select_strategy ()

gboolean            gdict_strategy_chooser_select_strategy
                                                        (GdictStrategyChooser *chooser,
                                                         const gchar *strat_name);

Selects strat_name, if available.

chooser :

a GdictStrategyChooser

strat_name :

the name of the strategy to select

Returns :

TRUE if the matching strategy was found and selected

Since 0.10


gdict_strategy_chooser_set_current_strategy ()

gboolean            gdict_strategy_chooser_set_current_strategy
                                                        (GdictStrategyChooser *chooser,
                                                         const gchar *strat_name);

Sets strat_name as the current matching strategy.

chooser :

a GdictStrategyChooser

strat_name :

the name of the matching strategy

Returns :

TRUE if the matching strategy was found

Since 0.10


gdict_strategy_chooser_unselect_strategy ()

gboolean            gdict_strategy_chooser_unselect_strategy
                                                        (GdictStrategyChooser *chooser,
                                                         const gchar *strat_name);

Unselects strat_name from the list.

chooser :

a GdictStrategyChooser

strat_name :

the name of the strategy to unselect

Returns :

TRUE if the matching strategy was found and successfully unselected

Since 0.10

Property Details

The "context" property

  "context"                  GdictContext*         : Read / Write / Construct

The GdictContext object used to retrieve the list of strategies.

Signal Details

The "strategy-activated" signal

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

chooser :

the widget that received the signal

name :

the name of the activated strategy

description :

the description of the activate strategy

user_data :

user data set when the signal handler was connected.