1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * GtkBindingSet: Keybinding manager for GtkObjects.
5 * Copyright (C) 1998 Tim Janik
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
24 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
25 * file for a list of people on the GTK+ Team. See the ChangeLog
26 * files for a list of changes. These files are distributed with
27 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
33 #include <gdkkeysyms.h>
34 #include "gtkbindings.h"
35 #include "gtkkeyhash.h"
36 #include "gtkwidget.h"
42 #define BINDING_MOD_MASK() (gtk_accelerator_get_default_mod_mask () | GDK_RELEASE_MASK)
45 /* --- structures --- */
53 /* --- variables --- */
54 static GHashTable *binding_entry_hash_table = NULL;
55 static GSList *binding_key_hashes = NULL;
56 static GSList *binding_set_list = NULL;
57 static const gchar key_class_binding_set[] = "gtk-class-binding-set";
58 static GQuark key_id_class_binding_set = 0;
61 /* --- functions --- */
62 static GtkBindingSignal*
63 binding_signal_new (const gchar *signal_name,
66 GtkBindingSignal *signal;
68 signal = (GtkBindingSignal *) g_malloc0 (sizeof (GtkBindingSignal) + (n_args > 0 ? n_args - 1 : 0) * sizeof (GtkBindingArg));
70 signal->signal_name = (gchar *)g_intern_string (signal_name);
71 signal->n_args = n_args;
77 binding_signal_free (GtkBindingSignal *sig)
81 for (i = 0; i < sig->n_args; i++)
83 if (G_TYPE_FUNDAMENTAL (sig->args[i].arg_type) == G_TYPE_STRING)
84 g_free (sig->args[i].d.string_data);
90 binding_entry_hash (gconstpointer key)
92 register const GtkBindingEntry *e = key;
102 binding_entries_compare (gconstpointer a,
105 register const GtkBindingEntry *ea = a;
106 register const GtkBindingEntry *eb = b;
108 return (ea->keyval == eb->keyval && ea->modifiers == eb->modifiers);
112 binding_key_hash_insert_entry (GtkKeyHash *key_hash,
113 GtkBindingEntry *entry)
115 guint keyval = entry->keyval;
117 /* We store lowercased accelerators. To deal with this, if <Shift>
118 * was specified, uppercase.
120 if (entry->modifiers & GDK_SHIFT_MASK)
122 if (keyval == GDK_Tab)
123 keyval = GDK_ISO_Left_Tab;
125 keyval = gdk_keyval_to_upper (keyval);
128 _gtk_key_hash_add_entry (key_hash, keyval, entry->modifiers & ~GDK_RELEASE_MASK, entry);
132 binding_key_hash_destroy (gpointer data)
134 GtkKeyHash *key_hash = data;
136 binding_key_hashes = g_slist_remove (binding_key_hashes, key_hash);
137 _gtk_key_hash_free (key_hash);
141 insert_entries_into_key_hash (gpointer key,
145 GtkKeyHash *key_hash = data;
146 GtkBindingEntry *entry = value;
148 for (; entry; entry = entry->hash_next)
149 binding_key_hash_insert_entry (key_hash, entry);
153 binding_key_hash_for_keymap (GdkKeymap *keymap)
155 static GQuark key_hash_quark = 0;
156 GtkKeyHash *key_hash;
159 key_hash_quark = g_quark_from_static_string ("gtk-binding-key-hash");
161 key_hash = g_object_get_qdata (G_OBJECT (keymap), key_hash_quark);
165 key_hash = _gtk_key_hash_new (keymap, NULL);
166 g_object_set_qdata_full (G_OBJECT (keymap), key_hash_quark, key_hash, binding_key_hash_destroy);
168 if (binding_entry_hash_table)
169 g_hash_table_foreach (binding_entry_hash_table,
170 insert_entries_into_key_hash,
173 binding_key_hashes = g_slist_prepend (binding_key_hashes, key_hash);
180 static GtkBindingEntry*
181 binding_entry_new (GtkBindingSet *binding_set,
183 GdkModifierType modifiers)
186 GtkBindingEntry *entry;
188 if (!binding_entry_hash_table)
189 binding_entry_hash_table = g_hash_table_new (binding_entry_hash, binding_entries_compare);
191 entry = g_new (GtkBindingEntry, 1);
192 entry->keyval = keyval;
193 entry->modifiers = modifiers;
194 entry->binding_set = binding_set,
195 entry->destroyed = FALSE;
196 entry->in_emission = FALSE;
197 entry->signals = NULL;
199 entry->set_next = binding_set->entries;
200 binding_set->entries = entry;
202 entry->hash_next = g_hash_table_lookup (binding_entry_hash_table, entry);
203 if (entry->hash_next)
204 g_hash_table_remove (binding_entry_hash_table, entry->hash_next);
205 g_hash_table_insert (binding_entry_hash_table, entry, entry);
207 for (tmp_list = binding_key_hashes; tmp_list; tmp_list = tmp_list->next)
209 GtkKeyHash *key_hash = tmp_list->data;
210 binding_key_hash_insert_entry (key_hash, entry);
217 binding_entry_free (GtkBindingEntry *entry)
219 GtkBindingSignal *sig;
221 g_assert (entry->set_next == NULL &&
222 entry->hash_next == NULL &&
223 entry->in_emission == FALSE &&
224 entry->destroyed == TRUE);
226 entry->destroyed = FALSE;
228 sig = entry->signals;
231 GtkBindingSignal *prev;
235 binding_signal_free (prev);
241 binding_entry_destroy (GtkBindingEntry *entry)
243 GtkBindingEntry *o_entry;
244 register GtkBindingEntry *tmp;
245 GtkBindingEntry *begin;
246 register GtkBindingEntry *last;
249 /* unlink from binding set
252 tmp = entry->binding_set->entries;
258 last->set_next = entry->set_next;
260 entry->binding_set->entries = entry->set_next;
264 tmp = last->set_next;
266 entry->set_next = NULL;
268 o_entry = g_hash_table_lookup (binding_entry_hash_table, entry);
277 last->hash_next = entry->hash_next;
279 begin = entry->hash_next;
283 tmp = last->hash_next;
285 entry->hash_next = NULL;
288 g_hash_table_remove (binding_entry_hash_table, entry);
289 else if (begin != o_entry)
291 g_hash_table_remove (binding_entry_hash_table, entry);
292 g_hash_table_insert (binding_entry_hash_table, begin, begin);
295 for (tmp_list = binding_key_hashes; tmp_list; tmp_list = tmp_list->next)
297 GtkKeyHash *key_hash = tmp_list->data;
298 _gtk_key_hash_remove_entry (key_hash, entry);
301 entry->destroyed = TRUE;
303 if (!entry->in_emission)
304 binding_entry_free (entry);
307 static GtkBindingEntry*
308 binding_ht_lookup_entry (GtkBindingSet *set,
310 GdkModifierType modifiers)
312 GtkBindingEntry lookup_entry = { 0 };
313 GtkBindingEntry *entry;
315 if (!binding_entry_hash_table)
318 lookup_entry.keyval = keyval;
319 lookup_entry.modifiers = modifiers;
321 entry = g_hash_table_lookup (binding_entry_hash_table, &lookup_entry);
322 for (; entry; entry = entry->hash_next)
323 if (entry->binding_set == set)
330 binding_compose_params (GtkObject *object,
340 params = g_new0 (GValue, query->n_params + 1);
343 /* The instance we emit on is the first object in the array
345 g_value_init (params, G_TYPE_OBJECT);
346 g_value_set_object (params, G_OBJECT (object));
349 types = query->param_types;
351 for (i = 1; i < query->n_params + 1 && valid; i++)
353 GValue tmp_value = { 0, };
355 g_value_init (params, *types);
357 switch (G_TYPE_FUNDAMENTAL (args->arg_type))
360 g_value_init (&tmp_value, G_TYPE_DOUBLE);
361 g_value_set_double (&tmp_value, args->d.double_data);
364 g_value_init (&tmp_value, G_TYPE_LONG);
365 g_value_set_long (&tmp_value, args->d.long_data);
368 /* gtk_rc_parse_flags/enum() has fancier parsing for this; we can't call
369 * that since we don't have a GParamSpec, so just do something simple
371 if (G_TYPE_FUNDAMENTAL (*types) == G_TYPE_ENUM)
373 GEnumClass *class = G_ENUM_CLASS (g_type_class_ref (*types));
377 if (args->arg_type == GTK_TYPE_IDENTIFIER)
379 GEnumValue *enum_value = NULL;
380 enum_value = g_enum_get_value_by_name (class, args->d.string_data);
382 enum_value = g_enum_get_value_by_nick (class, args->d.string_data);
385 g_value_init (&tmp_value, *types);
386 g_value_set_enum (&tmp_value, enum_value->value);
391 g_type_class_unref (class);
393 /* This is just a hack for compatibility with GTK+-1.2 where a string
394 * could be used for a single flag value / without the support for multiple
395 * values in gtk_rc_parse_flags(), this isn't very useful.
397 else if (G_TYPE_FUNDAMENTAL (*types) == G_TYPE_FLAGS)
399 GFlagsClass *class = G_FLAGS_CLASS (g_type_class_ref (*types));
403 if (args->arg_type == GTK_TYPE_IDENTIFIER)
405 GFlagsValue *flags_value = NULL;
406 flags_value = g_flags_get_value_by_name (class, args->d.string_data);
408 flags_value = g_flags_get_value_by_nick (class, args->d.string_data);
411 g_value_init (&tmp_value, *types);
412 g_value_set_flags (&tmp_value, flags_value->value);
417 g_type_class_unref (class);
421 g_value_init (&tmp_value, G_TYPE_STRING);
422 g_value_set_static_string (&tmp_value, args->d.string_data);
432 if (!g_value_transform (&tmp_value, params))
435 g_value_unset (&tmp_value);
447 for (j = 0; j < i; j++)
448 g_value_unset (&(*params_p)[j]);
458 gtk_binding_entry_activate (GtkBindingEntry *entry,
461 GtkBindingSignal *sig;
462 gboolean old_emission;
463 gboolean handled = FALSE;
466 old_emission = entry->in_emission;
467 entry->in_emission = TRUE;
469 g_object_ref (object);
471 for (sig = entry->signals; sig; sig = sig->next)
475 GValue *params = NULL;
476 GValue return_val = { 0, };
477 gchar *accelerator = NULL;
479 signal_id = g_signal_lookup (sig->signal_name, G_OBJECT_TYPE (object));
482 accelerator = gtk_accelerator_name (entry->keyval, entry->modifiers);
483 g_warning ("gtk_binding_entry_activate(): binding \"%s::%s\": "
484 "could not find signal \"%s\" in the `%s' class ancestry",
485 entry->binding_set->set_name,
488 g_type_name (G_OBJECT_TYPE (object)));
489 g_free (accelerator);
493 g_signal_query (signal_id, &query);
494 if (query.n_params != sig->n_args ||
495 (query.return_type != G_TYPE_NONE && query.return_type != G_TYPE_BOOLEAN) ||
496 !binding_compose_params (object, sig->args, &query, ¶ms))
498 accelerator = gtk_accelerator_name (entry->keyval, entry->modifiers);
499 g_warning ("gtk_binding_entry_activate(): binding \"%s::%s\": "
500 "signature mismatch for signal \"%s\" in the `%s' class ancestry",
501 entry->binding_set->set_name,
504 g_type_name (G_OBJECT_TYPE (object)));
506 else if (!(query.signal_flags & G_SIGNAL_ACTION))
508 accelerator = gtk_accelerator_name (entry->keyval, entry->modifiers);
509 g_warning ("gtk_binding_entry_activate(): binding \"%s::%s\": "
510 "signal \"%s\" in the `%s' class ancestry cannot be used for action emissions",
511 entry->binding_set->set_name,
514 g_type_name (G_OBJECT_TYPE (object)));
516 g_free (accelerator);
520 if (query.return_type == G_TYPE_BOOLEAN)
521 g_value_init (&return_val, G_TYPE_BOOLEAN);
523 g_signal_emitv (params, signal_id, 0, &return_val);
525 if (query.return_type == G_TYPE_BOOLEAN)
527 if (g_value_get_boolean (&return_val))
529 g_value_unset (&return_val);
534 for (i = 0; i < query.n_params + 1; i++)
535 g_value_unset (¶ms[i]);
538 if (entry->destroyed)
542 g_object_unref (object);
544 entry->in_emission = old_emission;
545 if (entry->destroyed && !entry->in_emission)
546 binding_entry_free (entry);
552 gtk_binding_set_new (const gchar *set_name)
554 GtkBindingSet *binding_set;
556 g_return_val_if_fail (set_name != NULL, NULL);
558 binding_set = g_new (GtkBindingSet, 1);
559 binding_set->set_name = g_intern_string (set_name);
560 binding_set->widget_path_pspecs = NULL;
561 binding_set->widget_class_pspecs = NULL;
562 binding_set->class_branch_pspecs = NULL;
563 binding_set->entries = NULL;
564 binding_set->current = NULL;
565 binding_set->parsed = FALSE;
567 binding_set_list = g_slist_prepend (binding_set_list, binding_set);
573 gtk_binding_set_by_class (gpointer object_class)
575 GtkObjectClass *class = object_class;
576 GtkBindingSet* binding_set;
578 g_return_val_if_fail (GTK_IS_OBJECT_CLASS (class), NULL);
580 if (!key_id_class_binding_set)
581 key_id_class_binding_set = g_quark_from_static_string (key_class_binding_set);
583 binding_set = g_dataset_id_get_data (class, key_id_class_binding_set);
588 binding_set = gtk_binding_set_new (g_type_name (G_OBJECT_CLASS_TYPE (class)));
589 gtk_binding_set_add_path (binding_set,
591 g_type_name (G_OBJECT_CLASS_TYPE (class)),
593 g_dataset_id_set_data (class, key_id_class_binding_set, binding_set);
599 gtk_binding_set_find (const gchar *set_name)
603 g_return_val_if_fail (set_name != NULL, NULL);
605 for (slist = binding_set_list; slist; slist = slist->next)
607 GtkBindingSet *binding_set;
609 binding_set = slist->data;
610 if (g_str_equal (binding_set->set_name, (gpointer) set_name))
617 gtk_binding_set_activate (GtkBindingSet *binding_set,
619 GdkModifierType modifiers,
622 GtkBindingEntry *entry;
624 g_return_val_if_fail (binding_set != NULL, FALSE);
625 g_return_val_if_fail (GTK_IS_OBJECT (object), FALSE);
627 keyval = gdk_keyval_to_lower (keyval);
628 modifiers = modifiers & BINDING_MOD_MASK ();
630 entry = binding_ht_lookup_entry (binding_set, keyval, modifiers);
632 return gtk_binding_entry_activate (entry, object);
638 gtk_binding_entry_clear (GtkBindingSet *binding_set,
640 GdkModifierType modifiers)
642 GtkBindingEntry *entry;
644 g_return_if_fail (binding_set != NULL);
646 keyval = gdk_keyval_to_lower (keyval);
647 modifiers = modifiers & BINDING_MOD_MASK ();
649 entry = binding_ht_lookup_entry (binding_set, keyval, modifiers);
651 binding_entry_destroy (entry);
653 entry = binding_entry_new (binding_set, keyval, modifiers);
657 gtk_binding_entry_remove (GtkBindingSet *binding_set,
659 GdkModifierType modifiers)
661 GtkBindingEntry *entry;
663 g_return_if_fail (binding_set != NULL);
665 keyval = gdk_keyval_to_lower (keyval);
666 modifiers = modifiers & BINDING_MOD_MASK ();
668 entry = binding_ht_lookup_entry (binding_set, keyval, modifiers);
670 binding_entry_destroy (entry);
674 gtk_binding_entry_add_signall (GtkBindingSet *binding_set,
676 GdkModifierType modifiers,
677 const gchar *signal_name,
678 GSList *binding_args)
680 GtkBindingEntry *entry;
681 GtkBindingSignal *signal, **signal_p;
686 g_return_if_fail (binding_set != NULL);
687 g_return_if_fail (signal_name != NULL);
689 keyval = gdk_keyval_to_lower (keyval);
690 modifiers = modifiers & BINDING_MOD_MASK ();
692 signal = binding_signal_new (signal_name, g_slist_length (binding_args));
695 for (slist = binding_args; slist; slist = slist->next)
697 GtkBindingArg *tmp_arg;
699 tmp_arg = slist->data;
702 g_warning ("gtk_binding_entry_add_signall(): arg[%u] is `NULL'", n);
703 binding_signal_free (signal);
706 switch (G_TYPE_FUNDAMENTAL (tmp_arg->arg_type))
709 arg->arg_type = G_TYPE_LONG;
710 arg->d.long_data = tmp_arg->d.long_data;
713 arg->arg_type = G_TYPE_DOUBLE;
714 arg->d.double_data = tmp_arg->d.double_data;
717 if (tmp_arg->arg_type != GTK_TYPE_IDENTIFIER)
718 arg->arg_type = G_TYPE_STRING;
720 arg->arg_type = GTK_TYPE_IDENTIFIER;
721 arg->d.string_data = g_strdup (tmp_arg->d.string_data);
722 if (!arg->d.string_data)
724 g_warning ("gtk_binding_entry_add_signall(): value of `string' arg[%u] is `NULL'", n);
725 binding_signal_free (signal);
730 g_warning ("gtk_binding_entry_add_signall(): unsupported type `%s' for arg[%u]",
731 g_type_name (arg->arg_type), n);
732 binding_signal_free (signal);
739 entry = binding_ht_lookup_entry (binding_set, keyval, modifiers);
742 gtk_binding_entry_add (binding_set, keyval, modifiers);
743 entry = binding_ht_lookup_entry (binding_set, keyval, modifiers);
745 signal_p = &entry->signals;
747 signal_p = &(*signal_p)->next;
752 gtk_binding_entry_add_signal (GtkBindingSet *binding_set,
754 GdkModifierType modifiers,
755 const gchar *signal_name,
759 GSList *slist, *free_slist;
763 g_return_if_fail (binding_set != NULL);
764 g_return_if_fail (signal_name != NULL);
766 va_start (args, n_args);
768 for (i = 0; i < n_args; i++)
772 arg = g_new0 (GtkBindingArg, 1);
773 slist = g_slist_prepend (slist, arg);
775 arg->arg_type = va_arg (args, GtkType);
776 switch (G_TYPE_FUNDAMENTAL (arg->arg_type))
778 /* for elaborated commenting about var args collection, take a look
779 * at gtk_arg_collect_value() in gtkargcollector.c
788 arg->arg_type = G_TYPE_LONG;
789 arg->d.long_data = va_arg (args, gint);
793 arg->arg_type = G_TYPE_LONG;
794 arg->d.long_data = va_arg (args, glong);
798 arg->arg_type = G_TYPE_DOUBLE;
799 arg->d.double_data = va_arg (args, gdouble);
802 if (arg->arg_type != GTK_TYPE_IDENTIFIER)
803 arg->arg_type = G_TYPE_STRING;
804 arg->d.string_data = va_arg (args, gchar*);
805 if (!arg->d.string_data)
807 g_warning ("gtk_binding_entry_add_signal(): type `%s' arg[%u] is `NULL'",
808 g_type_name (arg->arg_type),
814 g_warning ("gtk_binding_entry_add_signal(): unsupported type `%s' for arg[%u]",
815 g_type_name (arg->arg_type), i);
822 if (i == n_args || i == 0)
824 slist = g_slist_reverse (slist);
825 gtk_binding_entry_add_signall (binding_set, keyval, modifiers, signal_name, slist);
831 g_free (slist->data);
834 g_slist_free (free_slist);
838 gtk_binding_set_add_path (GtkBindingSet *binding_set,
839 GtkPathType path_type,
840 const gchar *path_pattern,
841 GtkPathPriorityType priority)
844 GSList **slist_p, *slist;
845 static guint seq_id = 0;
847 g_return_if_fail (binding_set != NULL);
848 g_return_if_fail (path_pattern != NULL);
849 g_return_if_fail (priority <= GTK_PATH_PRIO_MASK);
851 priority &= GTK_PATH_PRIO_MASK;
855 case GTK_PATH_WIDGET:
856 slist_p = &binding_set->widget_path_pspecs;
858 case GTK_PATH_WIDGET_CLASS:
859 slist_p = &binding_set->widget_class_pspecs;
862 slist_p = &binding_set->class_branch_pspecs;
865 g_assert_not_reached ();
870 pspec = g_new (PatternSpec, 1);
871 pspec->pspec = g_pattern_spec_new (path_pattern);
872 pspec->seq_id = priority << 28;
873 pspec->user_data = binding_set;
878 PatternSpec *tmp_pspec;
880 tmp_pspec = slist->data;
883 if (g_pattern_spec_equal (tmp_pspec->pspec, pspec->pspec))
885 GtkPathPriorityType lprio = tmp_pspec->seq_id >> 28;
887 g_pattern_spec_free (pspec->pspec);
890 if (lprio < priority)
892 tmp_pspec->seq_id &= 0x0fffffff;
893 tmp_pspec->seq_id |= priority << 28;
900 pspec->seq_id |= seq_id++ & 0x0fffffff;
901 *slist_p = g_slist_prepend (*slist_p, pspec);
906 binding_match_activate (GSList *pspec_list,
910 const gchar *path_reversed)
914 for (slist = pspec_list; slist; slist = slist->next)
919 if (g_pattern_match (pspec->pspec, path_length, path, path_reversed))
921 GtkBindingSet *binding_set;
923 binding_set = pspec->user_data;
925 if (gtk_binding_entry_activate (binding_set->current, object))
934 gtk_binding_pattern_compare (gconstpointer new_pattern,
935 gconstpointer existing_pattern)
937 register const PatternSpec *np = new_pattern;
938 register const PatternSpec *ep = existing_pattern;
940 /* walk the list as long as the existing patterns have
944 return np->seq_id < ep->seq_id;
948 gtk_binding_entries_sort_patterns (GSList *entries,
956 for (tmp_list = entries; tmp_list; tmp_list = tmp_list->next)
958 GtkBindingEntry *entry = tmp_list->data;
959 GtkBindingSet *binding_set;
961 binding_set = entry->binding_set;
962 binding_set->current = NULL;
965 for (; entries; entries = entries->next)
967 GtkBindingEntry *entry = entries->data;
968 GtkBindingSet *binding_set;
969 GSList *slist = NULL;
971 if (is_release != ((entry->modifiers & GDK_RELEASE_MASK) != 0))
974 binding_set = entry->binding_set;
976 if (binding_set->current)
978 binding_set->current = entry;
982 case GTK_PATH_WIDGET:
983 slist = binding_set->widget_path_pspecs;
985 case GTK_PATH_WIDGET_CLASS:
986 slist = binding_set->widget_class_pspecs;
989 slist = binding_set->class_branch_pspecs;
993 for (; slist; slist = slist->next)
998 patterns = g_slist_insert_sorted (patterns, pspec, gtk_binding_pattern_compare);
1006 gtk_bindings_activate_list (GtkObject *object,
1008 gboolean is_release)
1010 GtkWidget *widget = GTK_WIDGET (object);
1011 gboolean handled = FALSE;
1019 gchar *path, *path_reversed;
1022 gtk_widget_path (widget, &path_length, &path, &path_reversed);
1023 patterns = gtk_binding_entries_sort_patterns (entries, GTK_PATH_WIDGET, is_release);
1024 handled = binding_match_activate (patterns, object, path_length, path, path_reversed);
1025 g_slist_free (patterns);
1027 g_free (path_reversed);
1033 gchar *path, *path_reversed;
1036 gtk_widget_class_path (widget, &path_length, &path, &path_reversed);
1037 patterns = gtk_binding_entries_sort_patterns (entries, GTK_PATH_WIDGET_CLASS, is_release);
1038 handled = binding_match_activate (patterns, object, path_length, path, path_reversed);
1039 g_slist_free (patterns);
1041 g_free (path_reversed);
1049 patterns = gtk_binding_entries_sort_patterns (entries, GTK_PATH_CLASS, is_release);
1050 class_type = G_TYPE_FROM_INSTANCE (object);
1051 while (class_type && !handled)
1055 gchar *path_reversed;
1057 path = g_type_name (class_type);
1058 path_reversed = g_strdup (path);
1059 g_strreverse (path_reversed);
1060 path_length = strlen (path);
1061 handled = binding_match_activate (patterns, object, path_length, path, path_reversed);
1062 g_free (path_reversed);
1064 class_type = g_type_parent (class_type);
1066 g_slist_free (patterns);
1073 gtk_bindings_activate (GtkObject *object,
1075 GdkModifierType modifiers)
1077 GSList *entries = NULL;
1078 GdkDisplay *display;
1079 GtkKeyHash *key_hash;
1080 gboolean handled = FALSE;
1081 gboolean is_release;
1083 g_return_val_if_fail (GTK_IS_OBJECT (object), FALSE);
1085 if (!GTK_IS_WIDGET (object))
1088 is_release = (modifiers & GDK_RELEASE_MASK) != 0;
1089 modifiers = modifiers & BINDING_MOD_MASK () & ~GDK_RELEASE_MASK;
1091 display = gtk_widget_get_display (GTK_WIDGET (object));
1092 key_hash = binding_key_hash_for_keymap (gdk_keymap_get_for_display (display));
1094 entries = _gtk_key_hash_lookup_keyval (key_hash, keyval, modifiers);
1096 handled = gtk_bindings_activate_list (object, entries, is_release);
1098 g_slist_free (entries);
1104 * gtk_bindings_activate_event:
1105 * @object: a #GtkObject (generally must be a widget)
1106 * @event: a #GdkEventKey
1108 * Looks up key bindings for @object to find one matching
1109 * @event, and if one was found, activate it.
1111 * Return value: %TRUE if a matching key binding was found
1114 gtk_bindings_activate_event (GtkObject *object,
1117 GSList *entries = NULL;
1118 GdkDisplay *display;
1119 GtkKeyHash *key_hash;
1120 gboolean handled = FALSE;
1122 g_return_val_if_fail (GTK_IS_OBJECT (object), FALSE);
1124 if (!GTK_IS_WIDGET (object))
1127 display = gtk_widget_get_display (GTK_WIDGET (object));
1128 key_hash = binding_key_hash_for_keymap (gdk_keymap_get_for_display (display));
1130 entries = _gtk_key_hash_lookup (key_hash,
1131 event->hardware_keycode,
1133 BINDING_MOD_MASK () & ~GDK_RELEASE_MASK,
1136 handled = gtk_bindings_activate_list (object, entries,
1137 event->type == GDK_KEY_RELEASE);
1139 g_slist_free (entries);
1145 gtk_binding_parse_signal (GScanner *scanner,
1146 GtkBindingSet *binding_set,
1148 GdkModifierType modifiers)
1151 guint expected_token = 0;
1157 gboolean seen_comma;
1159 g_return_val_if_fail (scanner != NULL, G_TOKEN_ERROR);
1161 g_scanner_get_next_token (scanner);
1162 if (scanner->token != G_TOKEN_STRING)
1163 return G_TOKEN_STRING;
1164 g_scanner_peek_next_token (scanner);
1165 if (scanner->next_token != '(')
1167 g_scanner_get_next_token (scanner);
1170 signal = g_strdup (scanner->value.v_string);
1171 g_scanner_get_next_token (scanner);
1178 scanner->config->scan_symbols = FALSE;
1182 expected_token = G_TOKEN_INT;
1184 expected_token = ')';
1185 g_scanner_get_next_token (scanner);
1186 switch (scanner->token)
1194 arg = g_new (GtkBindingArg, 1);
1195 arg->arg_type = G_TYPE_DOUBLE;
1196 arg->d.double_data = scanner->value.v_float;
1199 arg->d.double_data = - arg->d.double_data;
1202 args = g_slist_prepend (args, arg);
1211 arg = g_new (GtkBindingArg, 1);
1212 arg->arg_type = G_TYPE_LONG;
1213 arg->d.long_data = scanner->value.v_int;
1216 arg->d.long_data = - arg->d.long_data;
1219 args = g_slist_prepend (args, arg);
1224 case G_TOKEN_STRING:
1225 if (need_arg && !negate)
1228 arg = g_new (GtkBindingArg, 1);
1229 arg->arg_type = G_TYPE_STRING;
1230 arg->d.string_data = g_strdup (scanner->value.v_string);
1231 args = g_slist_prepend (args, arg);
1236 case G_TOKEN_IDENTIFIER:
1237 if (need_arg && !negate)
1240 arg = g_new (GtkBindingArg, 1);
1241 arg->arg_type = GTK_TYPE_IDENTIFIER;
1242 arg->d.string_data = g_strdup (scanner->value.v_identifier);
1243 args = g_slist_prepend (args, arg);
1253 expected_token = G_TOKEN_INT;
1267 if (!(need_arg && seen_comma) && !negate)
1269 args = g_slist_reverse (args);
1270 gtk_binding_entry_add_signall (binding_set,
1275 expected_token = G_TOKEN_NONE;
1285 scanner->config->scan_symbols = TRUE;
1287 for (slist = args; slist; slist = slist->next)
1292 if (G_TYPE_FUNDAMENTAL (arg->arg_type) == G_TYPE_STRING)
1293 g_free (arg->d.string_data);
1296 g_slist_free (args);
1299 return expected_token;
1303 gtk_binding_parse_bind (GScanner *scanner,
1304 GtkBindingSet *binding_set)
1307 GdkModifierType modifiers = 0;
1309 g_return_val_if_fail (scanner != NULL, G_TOKEN_ERROR);
1311 g_scanner_get_next_token (scanner);
1312 if (scanner->token != GTK_RC_TOKEN_BIND)
1313 return GTK_RC_TOKEN_BIND;
1314 g_scanner_get_next_token (scanner);
1315 if (scanner->token != G_TOKEN_STRING)
1316 return G_TOKEN_STRING;
1317 gtk_accelerator_parse (scanner->value.v_string, &keyval, &modifiers);
1318 modifiers &= BINDING_MOD_MASK ();
1320 return G_TOKEN_STRING;
1322 g_scanner_get_next_token (scanner);
1323 if (scanner->token != '{')
1326 gtk_binding_entry_clear (binding_set, keyval, modifiers);
1328 g_scanner_peek_next_token (scanner);
1329 while (scanner->next_token != '}')
1331 switch (scanner->next_token)
1333 guint expected_token;
1335 case G_TOKEN_STRING:
1336 expected_token = gtk_binding_parse_signal (scanner,
1340 if (expected_token != G_TOKEN_NONE)
1341 return expected_token;
1344 g_scanner_get_next_token (scanner);
1347 g_scanner_peek_next_token (scanner);
1349 g_scanner_get_next_token (scanner);
1351 return G_TOKEN_NONE;
1355 gtk_binding_parse_binding (GScanner *scanner)
1358 GtkBindingSet *binding_set;
1360 g_return_val_if_fail (scanner != NULL, G_TOKEN_ERROR);
1362 g_scanner_get_next_token (scanner);
1363 if (scanner->token != GTK_RC_TOKEN_BINDING)
1364 return GTK_RC_TOKEN_BINDING;
1365 g_scanner_get_next_token (scanner);
1366 if (scanner->token != G_TOKEN_STRING)
1367 return G_TOKEN_STRING;
1368 name = g_strdup (scanner->value.v_string);
1370 g_scanner_get_next_token (scanner);
1371 if (scanner->token != '{')
1374 return G_TOKEN_STRING;
1377 binding_set = gtk_binding_set_find (name);
1380 binding_set = gtk_binding_set_new (name);
1381 binding_set->parsed = 1;
1385 g_scanner_peek_next_token (scanner);
1386 while (scanner->next_token != '}')
1388 switch (scanner->next_token)
1390 guint expected_token;
1392 case GTK_RC_TOKEN_BIND:
1393 expected_token = gtk_binding_parse_bind (scanner, binding_set);
1394 if (expected_token != G_TOKEN_NONE)
1395 return expected_token;
1398 g_scanner_get_next_token (scanner);
1401 g_scanner_peek_next_token (scanner);
1403 g_scanner_get_next_token (scanner);
1405 return G_TOKEN_NONE;
1409 free_pattern_specs (GSList *pattern_specs)
1413 for (slist = pattern_specs; slist; slist = slist->next)
1417 pspec = slist->data;
1419 g_pattern_spec_free (pspec->pspec);
1423 g_slist_free (pattern_specs);
1427 binding_set_delete (GtkBindingSet *binding_set)
1429 GtkBindingEntry *entry, *next;
1431 entry = binding_set->entries;
1434 next = entry->set_next;
1435 binding_entry_destroy (entry);
1439 free_pattern_specs (binding_set->widget_path_pspecs);
1440 free_pattern_specs (binding_set->widget_class_pspecs);
1441 free_pattern_specs (binding_set->class_branch_pspecs);
1443 g_free (binding_set);
1447 * _gtk_binding_reset_parsed:
1449 * Removing all binding sets that were added by
1450 * gtk_binding_parse_binding()
1453 _gtk_binding_reset_parsed (void)
1455 GSList *slist, *next;
1457 slist = binding_set_list;
1460 GtkBindingSet *binding_set;
1462 binding_set = slist->data;
1465 if (binding_set->parsed)
1467 binding_set_list = g_slist_delete_link (binding_set_list, slist);
1468 binding_set_delete (binding_set);
1476 _gtk_binding_signal_new (const gchar *signal_name,
1478 GSignalFlags signal_flags,
1480 GSignalAccumulator accumulator,
1482 GSignalCMarshaller c_marshaller,
1490 g_return_val_if_fail (signal_name != NULL, 0);
1492 va_start (args, n_params);
1494 signal_id = g_signal_new_valist (signal_name, itype, signal_flags,
1495 g_cclosure_new (handler, NULL, NULL),
1496 accumulator, accu_data, c_marshaller,
1497 return_type, n_params, args);
1504 #define __GTK_BINDINGS_C__
1505 #include "gtkaliasdef.c"