Bindings

Bindings — Key bindings for individual widgets

Synopsis


#include <gtk/gtk.h>


                    GtkBindingSet;
                    GtkBindingEntry;
                    GtkBindingSignal;
                    GtkBindingArg;
GtkBindingSet*      gtk_binding_set_new                 (const gchar *set_name);
GtkBindingSet*      gtk_binding_set_by_class            (gpointer object_class);
GtkBindingSet*      gtk_binding_set_find                (const gchar *set_name);
gboolean            gtk_bindings_activate               (GtkObject *object,
                                                         guint keyval,
                                                         GdkModifierType modifiers);
gboolean            gtk_bindings_activate_event         (GtkObject *object,
                                                         GdkEventKey *event);
gboolean            gtk_binding_set_activate            (GtkBindingSet *binding_set,
                                                         guint keyval,
                                                         GdkModifierType modifiers,
                                                         GtkObject *object);
#define             gtk_binding_entry_add
void                gtk_binding_entry_clear             (GtkBindingSet *binding_set,
                                                         guint keyval,
                                                         GdkModifierType modifiers);
void                gtk_binding_entry_add_signal        (GtkBindingSet *binding_set,
                                                         guint keyval,
                                                         GdkModifierType modifiers,
                                                         const gchar *signal_name,
                                                         guint n_args,
                                                         ...);
void                gtk_binding_set_add_path            (GtkBindingSet *binding_set,
                                                         GtkPathType path_type,
                                                         const gchar *path_pattern,
                                                         GtkPathPriorityType priority);
void                gtk_binding_entry_remove            (GtkBindingSet *binding_set,
                                                         guint keyval,
                                                         GdkModifierType modifiers);
void                gtk_binding_entry_add_signall       (GtkBindingSet *binding_set,
                                                         guint keyval,
                                                         GdkModifierType modifiers,
                                                         const gchar *signal_name,
                                                         GSList *binding_args);
guint               gtk_binding_parse_binding           (GScanner *scanner);

Description

Details

GtkBindingSet

typedef struct {
  gchar			*set_name;
  gint			 priority;
  GSList		*widget_path_pspecs;
  GSList		*widget_class_pspecs;
  GSList		*class_branch_pspecs;
  GtkBindingEntry	*entries;
  GtkBindingEntry	*current;
  guint                  parsed : 1; /* From RC content */
} GtkBindingSet;

GtkBindingEntry

typedef struct {
  /* key portion
   */
  guint			 keyval;
  GdkModifierType	 modifiers;
  
  GtkBindingSet		*binding_set;
  guint			destroyed : 1;
  guint			in_emission : 1;
  GtkBindingEntry	*set_next;
  GtkBindingEntry	*hash_next;
  GtkBindingSignal	*signals;
} GtkBindingEntry;

GtkBindingSignal

typedef struct {
  GtkBindingSignal	*next;
  gchar 		*signal_name;
  guint			 n_args;
  GtkBindingArg		*args;
} GtkBindingSignal;

GtkBindingArg

typedef struct {
  GType		 arg_type;
  union {
    glong	 long_data;
    gdouble	 double_data;
    gchar	*string_data;
  } d;
} GtkBindingArg;

gtk_binding_set_new ()

GtkBindingSet*      gtk_binding_set_new                 (const gchar *set_name);

set_name :
Returns :

gtk_binding_set_by_class ()

GtkBindingSet*      gtk_binding_set_by_class            (gpointer object_class);

object_class :
Returns :

gtk_binding_set_find ()

GtkBindingSet*      gtk_binding_set_find                (const gchar *set_name);

set_name :
Returns :

gtk_bindings_activate ()

gboolean            gtk_bindings_activate               (GtkObject *object,
                                                         guint keyval,
                                                         GdkModifierType modifiers);

object :
keyval :
modifiers :
Returns :

gtk_bindings_activate_event ()

gboolean            gtk_bindings_activate_event         (GtkObject *object,
                                                         GdkEventKey *event);

Looks up key bindings for object to find one matching event, and if one was found, activate it.

object : a GtkObject (generally must be a widget)
event : a GdkEventKey
Returns : TRUE if a matching key binding was found

gtk_binding_set_activate ()

gboolean            gtk_binding_set_activate            (GtkBindingSet *binding_set,
                                                         guint keyval,
                                                         GdkModifierType modifiers,
                                                         GtkObject *object);

binding_set :
keyval :
modifiers :
object :
Returns :

gtk_binding_entry_add

#define	 gtk_binding_entry_add		gtk_binding_entry_clear

gtk_binding_entry_clear ()

void                gtk_binding_entry_clear             (GtkBindingSet *binding_set,
                                                         guint keyval,
                                                         GdkModifierType modifiers);

binding_set :
keyval :
modifiers :

gtk_binding_entry_add_signal ()

void                gtk_binding_entry_add_signal        (GtkBindingSet *binding_set,
                                                         guint keyval,
                                                         GdkModifierType modifiers,
                                                         const gchar *signal_name,
                                                         guint n_args,
                                                         ...);

binding_set :
keyval :
modifiers :
signal_name :
n_args :
... :

gtk_binding_set_add_path ()

void                gtk_binding_set_add_path            (GtkBindingSet *binding_set,
                                                         GtkPathType path_type,
                                                         const gchar *path_pattern,
                                                         GtkPathPriorityType priority);

binding_set :
path_type :
path_pattern :
priority :

gtk_binding_entry_remove ()

void                gtk_binding_entry_remove            (GtkBindingSet *binding_set,
                                                         guint keyval,
                                                         GdkModifierType modifiers);

binding_set :
keyval :
modifiers :

gtk_binding_entry_add_signall ()

void                gtk_binding_entry_add_signall       (GtkBindingSet *binding_set,
                                                         guint keyval,
                                                         GdkModifierType modifiers,
                                                         const gchar *signal_name,
                                                         GSList *binding_args);

binding_set :
keyval :
modifiers :
signal_name :
binding_args :

gtk_binding_parse_binding ()

guint               gtk_binding_parse_binding           (GScanner *scanner);

scanner :
Returns :