gtkbindings.c 41.3 KB
Newer Older
Cody Russell's avatar
Cody Russell committed
1
/* GTK - The GIMP Toolkit
Tim Janik's avatar
Tim Janik committed
2 3 4 5 6 7
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * GtkBindingSet: Keybinding manager for GtkObjects.
 * Copyright (C) 1998 Tim Janik
 *
 * This library is free software; you can redistribute it and/or
8
 * modify it under the terms of the GNU Lesser General Public
Tim Janik's avatar
Tim Janik committed
9 10 11 12 13 14
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
15
 * Lesser General Public License for more details.
Tim Janik's avatar
Tim Janik committed
16
 *
17
 * You should have received a copy of the GNU Lesser General Public
Tim Janik's avatar
Tim Janik committed
18 19 20 21
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */
22 23

/*
24
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
25 26 27 28 29
 * file for a list of people on the GTK+ Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
 */

30
#include "config.h"
31
#include <string.h>
Tim Janik's avatar
Tim Janik committed
32
#include <stdarg.h>
33
#include <gdkkeysyms.h>
34

Tim Janik's avatar
Tim Janik committed
35
#include "gtkbindings.h"
36
#include "gtkkeyhash.h"
Tim Janik's avatar
Tim Janik committed
37
#include "gtkwidget.h"
38
#include "gtkrc.h"
Tim Janik's avatar
Tim Janik committed
39 40 41


/* --- defines --- */
42
#define	BINDING_MOD_MASK()	(gtk_accelerator_get_default_mod_mask () | GDK_RELEASE_MASK)
Tim Janik's avatar
Tim Janik committed
43 44


45 46
/* --- structures --- */
typedef struct {
47
  GtkPathType   type;
48
  GPatternSpec *pspec;
49 50 51
  GSList       *path;
  gpointer      user_data;
  guint         seq_id;
52 53 54
} PatternSpec;


Tim Janik's avatar
Tim Janik committed
55 56
/* --- variables --- */
static GHashTable	*binding_entry_hash_table = NULL;
57
static GSList           *binding_key_hashes = NULL;
Tim Janik's avatar
Tim Janik committed
58
static GSList		*binding_set_list = NULL;
59
static const gchar	 key_class_binding_set[] = "gtk-class-binding-set";
60
static GQuark		 key_id_class_binding_set = 0;
Tim Janik's avatar
Tim Janik committed
61 62 63


/* --- functions --- */
64 65 66 67 68 69 70 71 72
static void
pattern_spec_free (PatternSpec *pspec)
{
  _gtk_rc_free_widget_class_path (pspec->path);
  if (pspec->pspec)
    g_pattern_spec_free (pspec->pspec);
  g_free (pspec);
}

Tim Janik's avatar
Tim Janik committed
73 74 75 76 77
static GtkBindingSignal*
binding_signal_new (const gchar *signal_name,
		    guint	 n_args)
{
  GtkBindingSignal *signal;
78

79
  signal = (GtkBindingSignal *) g_slice_alloc0 (sizeof (GtkBindingSignal) + n_args * sizeof (GtkBindingArg));
Tim Janik's avatar
Tim Janik committed
80
  signal->next = NULL;
81
  signal->signal_name = (gchar *)g_intern_string (signal_name);
Tim Janik's avatar
Tim Janik committed
82
  signal->n_args = n_args;
83
  signal->args = (GtkBindingArg *)(signal + 1);
Tim Janik's avatar
Tim Janik committed
84 85 86 87 88 89 90 91 92 93 94
  
  return signal;
}

static void
binding_signal_free (GtkBindingSignal *sig)
{
  guint i;
  
  for (i = 0; i < sig->n_args; i++)
    {
Manish Singh's avatar
Manish Singh committed
95
      if (G_TYPE_FUNDAMENTAL (sig->args[i].arg_type) == G_TYPE_STRING)
Tim Janik's avatar
Tim Janik committed
96
	g_free (sig->args[i].d.string_data);
Tim Janik's avatar
Tim Janik committed
97
    }
98
  g_slice_free1 (sizeof (GtkBindingSignal) + sig->n_args * sizeof (GtkBindingArg), sig);
Tim Janik's avatar
Tim Janik committed
99 100 101
}

static guint
102
binding_entry_hash (gconstpointer  key)
Tim Janik's avatar
Tim Janik committed
103
{
104
  register const GtkBindingEntry *e = key;
Tim Janik's avatar
Tim Janik committed
105 106 107 108 109 110 111 112 113
  register guint h;

  h = e->keyval;
  h ^= e->modifiers;

  return h;
}

static gint
114 115
binding_entries_compare (gconstpointer  a,
			 gconstpointer  b)
Tim Janik's avatar
Tim Janik committed
116
{
117 118
  register const GtkBindingEntry *ea = a;
  register const GtkBindingEntry *eb = b;
Tim Janik's avatar
Tim Janik committed
119 120 121 122

  return (ea->keyval == eb->keyval && ea->modifiers == eb->modifiers);
}

123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191
static void
binding_key_hash_insert_entry (GtkKeyHash      *key_hash,
			       GtkBindingEntry *entry)
{
  guint keyval = entry->keyval;
  
  /* We store lowercased accelerators. To deal with this, if <Shift>
   * was specified, uppercase.
   */
  if (entry->modifiers & GDK_SHIFT_MASK)
    {
      if (keyval == GDK_Tab)
	keyval = GDK_ISO_Left_Tab;
      else
	keyval = gdk_keyval_to_upper (keyval);
    }
  
  _gtk_key_hash_add_entry (key_hash, keyval, entry->modifiers & ~GDK_RELEASE_MASK, entry);
}

static void
binding_key_hash_destroy (gpointer data)
{
  GtkKeyHash *key_hash = data;
  
  binding_key_hashes = g_slist_remove (binding_key_hashes, key_hash);
  _gtk_key_hash_free (key_hash);
}

static void
insert_entries_into_key_hash (gpointer key,
			      gpointer value,
			      gpointer data)
{
  GtkKeyHash *key_hash = data;
  GtkBindingEntry *entry = value;

  for (; entry; entry = entry->hash_next)
    binding_key_hash_insert_entry (key_hash, entry);
}

static GtkKeyHash *
binding_key_hash_for_keymap (GdkKeymap *keymap)
{
  static GQuark key_hash_quark = 0;
  GtkKeyHash *key_hash;

  if (!key_hash_quark)
    key_hash_quark = g_quark_from_static_string ("gtk-binding-key-hash");
  
  key_hash = g_object_get_qdata (G_OBJECT (keymap), key_hash_quark);

  if (!key_hash)
    {
      key_hash = _gtk_key_hash_new (keymap, NULL);
      g_object_set_qdata_full (G_OBJECT (keymap), key_hash_quark, key_hash, binding_key_hash_destroy);

      if (binding_entry_hash_table)
	g_hash_table_foreach (binding_entry_hash_table,
			      insert_entries_into_key_hash,
			      key_hash);

      binding_key_hashes = g_slist_prepend (binding_key_hashes, key_hash);
    }

  return key_hash;
}


Tim Janik's avatar
Tim Janik committed
192
static GtkBindingEntry*
193 194 195
binding_entry_new (GtkBindingSet  *binding_set,
		   guint           keyval,
		   GdkModifierType modifiers)
Tim Janik's avatar
Tim Janik committed
196
{
197
  GSList *tmp_list;
Tim Janik's avatar
Tim Janik committed
198 199 200 201 202 203 204 205 206 207 208
  GtkBindingEntry *entry;
  
  if (!binding_entry_hash_table)
    binding_entry_hash_table = g_hash_table_new (binding_entry_hash, binding_entries_compare);

  entry = g_new (GtkBindingEntry, 1);
  entry->keyval = keyval;
  entry->modifiers = modifiers;
  entry->binding_set = binding_set,
  entry->destroyed = FALSE;
  entry->in_emission = FALSE;
209
  entry->marks_unbound = FALSE;
Tim Janik's avatar
Tim Janik committed
210 211 212 213 214 215 216 217 218
  entry->signals = NULL;

  entry->set_next = binding_set->entries;
  binding_set->entries = entry;

  entry->hash_next = g_hash_table_lookup (binding_entry_hash_table, entry);
  if (entry->hash_next)
    g_hash_table_remove (binding_entry_hash_table, entry->hash_next);
  g_hash_table_insert (binding_entry_hash_table, entry, entry);
219 220 221 222 223 224

  for (tmp_list = binding_key_hashes; tmp_list; tmp_list = tmp_list->next)
    {
      GtkKeyHash *key_hash = tmp_list->data;
      binding_key_hash_insert_entry (key_hash, entry);
    }
Tim Janik's avatar
Tim Janik committed
225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259
  
  return entry;
}

static void
binding_entry_free (GtkBindingEntry *entry)
{
  GtkBindingSignal *sig;

  g_assert (entry->set_next == NULL &&
	    entry->hash_next == NULL &&
	    entry->in_emission == FALSE &&
	    entry->destroyed == TRUE);

  entry->destroyed = FALSE;
  
  sig = entry->signals;
  while (sig)
    {
      GtkBindingSignal *prev;
      
      prev = sig;
      sig = prev->next;
      binding_signal_free (prev);
    }
  g_free (entry);
}

static void
binding_entry_destroy (GtkBindingEntry *entry)
{
  GtkBindingEntry *o_entry;
  register GtkBindingEntry *tmp;
  GtkBindingEntry *begin;
  register GtkBindingEntry *last;
260
  GSList *tmp_list;
Tim Janik's avatar
Tim Janik committed
261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307

  /* unlink from binding set
   */
  last = NULL;
  tmp = entry->binding_set->entries;
  while (tmp)
    {
      if (tmp == entry)
	{
	  if (last)
	    last->set_next = entry->set_next;
	  else
	    entry->binding_set->entries = entry->set_next;
	  break;
	}
      last = tmp;
      tmp = last->set_next;
    }
  entry->set_next = NULL;
  
  o_entry = g_hash_table_lookup (binding_entry_hash_table, entry);
  begin = o_entry;
  last = NULL;
  tmp = begin;
  while (tmp)
    {
      if (tmp == entry)
	{
	  if (last)
	    last->hash_next = entry->hash_next;
	  else
	    begin = entry->hash_next;
	  break;
	}
      last = tmp;
      tmp = last->hash_next;
    }
  entry->hash_next = NULL;
  
  if (!begin)
    g_hash_table_remove (binding_entry_hash_table, entry);
  else if (begin != o_entry)
    {
      g_hash_table_remove (binding_entry_hash_table, entry);
      g_hash_table_insert (binding_entry_hash_table, begin, begin);
    }

308 309 310 311 312 313
  for (tmp_list = binding_key_hashes; tmp_list; tmp_list = tmp_list->next)
    {
      GtkKeyHash *key_hash = tmp_list->data;
      _gtk_key_hash_remove_entry (key_hash, entry);
    }

Tim Janik's avatar
Tim Janik committed
314 315 316 317 318 319 320
  entry->destroyed = TRUE;

  if (!entry->in_emission)
    binding_entry_free (entry);
}

static GtkBindingEntry*
321 322 323
binding_ht_lookup_entry (GtkBindingSet  *set,
			 guint		 keyval,
			 GdkModifierType modifiers)
Tim Janik's avatar
Tim Janik committed
324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342
{
  GtkBindingEntry lookup_entry = { 0 };
  GtkBindingEntry *entry;
  
  if (!binding_entry_hash_table)
    return NULL;
  
  lookup_entry.keyval = keyval;
  lookup_entry.modifiers = modifiers;
  
  entry = g_hash_table_lookup (binding_entry_hash_table, &lookup_entry);
  for (; entry; entry = entry->hash_next)
    if (entry->binding_set == set)
      return entry;

  return NULL;
}

static gboolean
343 344
binding_compose_params (GtkObject       *object,
			GtkBindingArg	*args,
345
			GSignalQuery	*query,
346
			GValue	       **params_p)
Tim Janik's avatar
Tim Janik committed
347
{
348 349
  GValue *params;
  const GType *types;
Tim Janik's avatar
Tim Janik committed
350 351 352
  guint i;
  gboolean valid;
  
353
  params = g_new0 (GValue, query->n_params + 1);
Tim Janik's avatar
Tim Janik committed
354
  *params_p = params;
355 356 357 358 359 360

  /* The instance we emit on is the first object in the array
   */
  g_value_init (params, G_TYPE_OBJECT);
  g_value_set_object (params, G_OBJECT (object));
  params++;
Tim Janik's avatar
Tim Janik committed
361
  
362
  types = query->param_types;
Tim Janik's avatar
Tim Janik committed
363
  valid = TRUE;
364
  for (i = 1; i < query->n_params + 1 && valid; i++)
Tim Janik's avatar
Tim Janik committed
365
    {
366
      GValue tmp_value = { 0, };
367

368 369 370
      g_value_init (params, *types);

      switch (G_TYPE_FUNDAMENTAL (args->arg_type))
Tim Janik's avatar
Tim Janik committed
371
	{
372 373 374
	case G_TYPE_DOUBLE:
	  g_value_init (&tmp_value, G_TYPE_DOUBLE);
	  g_value_set_double (&tmp_value, args->d.double_data);
Tim Janik's avatar
Tim Janik committed
375
	  break;
Manish Singh's avatar
Manish Singh committed
376
	case G_TYPE_LONG:
377 378
	  g_value_init (&tmp_value, G_TYPE_LONG);
	  g_value_set_long (&tmp_value, args->d.long_data);
Tim Janik's avatar
Tim Janik committed
379
	  break;
Manish Singh's avatar
Manish Singh committed
380
	case G_TYPE_STRING:
381 382 383 384
	  /* gtk_rc_parse_flags/enum() has fancier parsing for this; we can't call
	   * that since we don't have a GParamSpec, so just do something simple
	   */
	  if (G_TYPE_FUNDAMENTAL (*types) == G_TYPE_ENUM)
385
	    {
386 387 388 389 390 391 392 393 394 395 396 397
	      GEnumClass *class = G_ENUM_CLASS (g_type_class_ref (*types));
	      
	      valid = FALSE;
	      
	      if (args->arg_type == GTK_TYPE_IDENTIFIER)
		{
		  GEnumValue *enum_value = NULL;
		  enum_value = g_enum_get_value_by_name (class, args->d.string_data);
		  if (!enum_value)
		    enum_value = g_enum_get_value_by_nick (class, args->d.string_data);
		  if (enum_value)
		    {
398
		      g_value_init (&tmp_value, *types);
399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423
		      g_value_set_enum (&tmp_value, enum_value->value);
		      valid = TRUE;
		    }
		}

	      g_type_class_unref (class);
	    }
	  /* This is just a hack for compatibility with GTK+-1.2 where a string
	   * could be used for a single flag value / without the support for multiple
	   * values in gtk_rc_parse_flags(), this isn't very useful.
	   */
	  else if (G_TYPE_FUNDAMENTAL (*types) == G_TYPE_FLAGS)
	    {
	      GFlagsClass *class = G_FLAGS_CLASS (g_type_class_ref (*types));
	      
	      valid = FALSE;
	      
	      if (args->arg_type == GTK_TYPE_IDENTIFIER)
		{
		  GFlagsValue *flags_value = NULL;
		  flags_value = g_flags_get_value_by_name (class, args->d.string_data);
		  if (!flags_value)
		    flags_value = g_flags_get_value_by_nick (class, args->d.string_data);
		  if (flags_value)
		    {
424
		      g_value_init (&tmp_value, *types);
425 426 427 428 429 430
		      g_value_set_flags (&tmp_value, flags_value->value);
		      valid = TRUE;
		    }
		}

	      g_type_class_unref (class);
431
	    }
432
	  else
433 434
	    {
	      g_value_init (&tmp_value, G_TYPE_STRING);
435
	      g_value_set_static_string (&tmp_value, args->d.string_data);
436
	    }
437
	  break;
Tim Janik's avatar
Tim Janik committed
438 439 440 441
	default:
	  valid = FALSE;
	  break;
	}
442

443 444 445 446
      if (valid)
	{
	  if (!g_value_transform (&tmp_value, params))
	    valid = FALSE;
447

448 449
	  g_value_unset (&tmp_value);
	}
450
      
Tim Janik's avatar
Tim Janik committed
451 452 453 454 455 456 457
      types++;
      params++;
      args++;
    }
  
  if (!valid)
    {
458 459 460 461 462
      guint j;

      for (j = 0; j < i; j++)
	g_value_unset (&(*params_p)[j]);
      
Tim Janik's avatar
Tim Janik committed
463 464 465 466 467 468 469
      g_free (*params_p);
      *params_p = NULL;
    }
  
  return valid;
}

470 471 472
static gboolean
gtk_binding_entry_activate (GtkBindingEntry *entry,
			    GtkObject	    *object)
Tim Janik's avatar
Tim Janik committed
473 474 475
{
  GtkBindingSignal *sig;
  gboolean old_emission;
476 477
  gboolean handled = FALSE;
  gint i;
Tim Janik's avatar
Tim Janik committed
478 479 480 481
  
  old_emission = entry->in_emission;
  entry->in_emission = TRUE;
  
482
  g_object_ref (object);
Tim Janik's avatar
Tim Janik committed
483 484 485
  
  for (sig = entry->signals; sig; sig = sig->next)
    {
486
      GSignalQuery query;
Tim Janik's avatar
Tim Janik committed
487
      guint signal_id;
488 489
      GValue *params = NULL;
      GValue return_val = { 0, };
490
      gchar *accelerator = NULL;
Tim Janik's avatar
Tim Janik committed
491
      
492
      signal_id = g_signal_lookup (sig->signal_name, G_OBJECT_TYPE (object));
Tim Janik's avatar
Tim Janik committed
493 494 495 496 497 498 499 500
      if (!signal_id)
	{
	  accelerator = gtk_accelerator_name (entry->keyval, entry->modifiers);
	  g_warning ("gtk_binding_entry_activate(): binding \"%s::%s\": "
		     "could not find signal \"%s\" in the `%s' class ancestry",
		     entry->binding_set->set_name,
		     accelerator,
		     sig->signal_name,
501
		     g_type_name (G_OBJECT_TYPE (object)));
Tim Janik's avatar
Tim Janik committed
502 503 504 505
	  g_free (accelerator);
	  continue;
	}
      
506 507
      g_signal_query (signal_id, &query);
      if (query.n_params != sig->n_args ||
508 509
	  (query.return_type != G_TYPE_NONE && query.return_type != G_TYPE_BOOLEAN) || 
	  !binding_compose_params (object, sig->args, &query, &params))
Tim Janik's avatar
Tim Janik committed
510 511 512 513 514 515 516
	{
	  accelerator = gtk_accelerator_name (entry->keyval, entry->modifiers);
	  g_warning ("gtk_binding_entry_activate(): binding \"%s::%s\": "
		     "signature mismatch for signal \"%s\" in the `%s' class ancestry",
		     entry->binding_set->set_name,
		     accelerator,
		     sig->signal_name,
517
		     g_type_name (G_OBJECT_TYPE (object)));
Tim Janik's avatar
Tim Janik committed
518
	}
Manish Singh's avatar
Manish Singh committed
519
      else if (!(query.signal_flags & G_SIGNAL_ACTION))
520 521 522 523 524 525 526
	{
	  accelerator = gtk_accelerator_name (entry->keyval, entry->modifiers);
	  g_warning ("gtk_binding_entry_activate(): binding \"%s::%s\": "
		     "signal \"%s\" in the `%s' class ancestry cannot be used for action emissions",
		     entry->binding_set->set_name,
		     accelerator,
		     sig->signal_name,
527
		     g_type_name (G_OBJECT_TYPE (object)));
528 529 530 531
	}
      g_free (accelerator);
      if (accelerator)
	continue;
Tim Janik's avatar
Tim Janik committed
532

533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548
      if (query.return_type == G_TYPE_BOOLEAN)
	g_value_init (&return_val, G_TYPE_BOOLEAN);
      
      g_signal_emitv (params, signal_id, 0, &return_val);

      if (query.return_type == G_TYPE_BOOLEAN)
	{
	  if (g_value_get_boolean (&return_val))
	    handled = TRUE;
	  g_value_unset (&return_val);
	}
      else
	handled = TRUE;
      
      for (i = 0; i < query.n_params + 1; i++)
	g_value_unset (&params[i]);
Tim Janik's avatar
Tim Janik committed
549 550
      g_free (params);
      
551
      if (entry->destroyed)
Tim Janik's avatar
Tim Janik committed
552 553 554
	break;
    }
  
555
  g_object_unref (object);
Tim Janik's avatar
Tim Janik committed
556 557 558 559

  entry->in_emission = old_emission;
  if (entry->destroyed && !entry->in_emission)
    binding_entry_free (entry);
560 561

  return handled;
Tim Janik's avatar
Tim Janik committed
562 563
}

564 565 566 567
/**
 * gtk_binding_set_new:
 * @set_name: unique name of this binding set
 *
Matthias Clasen's avatar
Matthias Clasen committed
568
 * GTK+ maintains a global list of binding sets. Each binding set has
569 570 571
 * a unique name which needs to be specified upon creation.
 *
 * Return value: new binding set
Matthias Clasen's avatar
Matthias Clasen committed
572
 */
Tim Janik's avatar
Tim Janik committed
573
GtkBindingSet*
574
gtk_binding_set_new (const gchar *set_name)
Tim Janik's avatar
Tim Janik committed
575 576 577 578 579 580
{
  GtkBindingSet *binding_set;
  
  g_return_val_if_fail (set_name != NULL, NULL);
  
  binding_set = g_new (GtkBindingSet, 1);
581
  binding_set->set_name = (gchar *) g_intern_string (set_name);
Tim Janik's avatar
Tim Janik committed
582 583 584 585 586
  binding_set->widget_path_pspecs = NULL;
  binding_set->widget_class_pspecs = NULL;
  binding_set->class_branch_pspecs = NULL;
  binding_set->entries = NULL;
  binding_set->current = NULL;
587
  binding_set->parsed = FALSE;
Tim Janik's avatar
Tim Janik committed
588
  
589
  binding_set_list = g_slist_prepend (binding_set_list, binding_set);
Tim Janik's avatar
Tim Janik committed
590 591 592 593
  
  return binding_set;
}

594 595 596 597 598 599 600 601 602
/**
 * gtk_binding_set_by_class:
 * @object_class: a valid #GtkObject class
 *
 * This function returns the binding set named after the type name of
 * the passed in class structure. New binding sets are created on
 * demand by this function.
 *
 * Return value: the binding set corresponding to @object_class
Matthias Clasen's avatar
Matthias Clasen committed
603
 */
Tim Janik's avatar
Tim Janik committed
604 605 606 607 608 609 610 611 612
GtkBindingSet*
gtk_binding_set_by_class (gpointer object_class)
{
  GtkObjectClass *class = object_class;
  GtkBindingSet* binding_set;

  g_return_val_if_fail (GTK_IS_OBJECT_CLASS (class), NULL);

  if (!key_id_class_binding_set)
613
    key_id_class_binding_set = g_quark_from_static_string (key_class_binding_set);
Tim Janik's avatar
Tim Janik committed
614 615 616 617 618 619

  binding_set = g_dataset_id_get_data (class, key_id_class_binding_set);

  if (binding_set)
    return binding_set;

Manish Singh's avatar
Manish Singh committed
620
  binding_set = gtk_binding_set_new (g_type_name (G_OBJECT_CLASS_TYPE (class)));
Tim Janik's avatar
Tim Janik committed
621 622
  gtk_binding_set_add_path (binding_set,
			    GTK_PATH_CLASS,
Manish Singh's avatar
Manish Singh committed
623
			    g_type_name (G_OBJECT_CLASS_TYPE (class)),
Tim Janik's avatar
Tim Janik committed
624 625 626 627 628 629
			    GTK_PATH_PRIO_GTK);
  g_dataset_id_set_data (class, key_id_class_binding_set, binding_set);

  return binding_set;
}

630 631 632 633 634 635 636 637 638
/**
 * gtk_binding_set_find:
 * @set_name: unique binding set name
 *
 * Find a binding set by its globally unique name. The @set_name can
 * either be a name used for gtk_binding_set_new() or the type name of
 * a class used in gtk_binding_set_by_class().
 *
 * Return value: %NULL or the specified binding set
Matthias Clasen's avatar
Matthias Clasen committed
639
 */
Tim Janik's avatar
Tim Janik committed
640
GtkBindingSet*
641
gtk_binding_set_find (const gchar *set_name)
Tim Janik's avatar
Tim Janik committed
642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657
{
  GSList *slist;
  
  g_return_val_if_fail (set_name != NULL, NULL);
  
  for (slist = binding_set_list; slist; slist = slist->next)
    {
      GtkBindingSet *binding_set;
      
      binding_set = slist->data;
      if (g_str_equal (binding_set->set_name, (gpointer) set_name))
	return binding_set;
    }
  return NULL;
}

658 659
/**
 * gtk_binding_set_activate:
Matthias Clasen's avatar
Matthias Clasen committed
660
 * @binding_set: a #GtkBindingSet set to activate
661 662 663 664 665 666 667 668
 * @keyval:      key value of the binding
 * @modifiers:   key modifier of the binding
 * @object:      object to activate when binding found
 *
 * Find a key binding matching @keyval and @modifiers within
 * @binding_set and activate the binding on @object.
 *
 * Return value: %TRUE if a binding was found and activated
Matthias Clasen's avatar
Matthias Clasen committed
669
 */
Tim Janik's avatar
Tim Janik committed
670 671 672
gboolean
gtk_binding_set_activate (GtkBindingSet	 *binding_set,
			  guint		  keyval,
673
			  GdkModifierType modifiers,
Tim Janik's avatar
Tim Janik committed
674 675 676 677 678 679 680 681 682 683
			  GtkObject	 *object)
{
  GtkBindingEntry *entry;
  
  g_return_val_if_fail (binding_set != NULL, FALSE);
  g_return_val_if_fail (GTK_IS_OBJECT (object), FALSE);
  
  keyval = gdk_keyval_to_lower (keyval);
  modifiers = modifiers & BINDING_MOD_MASK ();
  
684 685
  entry = binding_ht_lookup_entry (binding_set, keyval, modifiers);
  if (entry)
686
    return gtk_binding_entry_activate (entry, object);
Tim Janik's avatar
Tim Janik committed
687 688 689 690
  
  return FALSE;
}

691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707
static void
gtk_binding_entry_clear_internal (GtkBindingSet  *binding_set,
                                  guint           keyval,
                                  GdkModifierType modifiers)
{
  GtkBindingEntry *entry;

  keyval = gdk_keyval_to_lower (keyval);
  modifiers = modifiers & BINDING_MOD_MASK ();

  entry = binding_ht_lookup_entry (binding_set, keyval, modifiers);
  if (entry)
    binding_entry_destroy (entry);

  entry = binding_entry_new (binding_set, keyval, modifiers);
}

708 709
/**
 * gtk_binding_entry_skip:
Matthias Clasen's avatar
Matthias Clasen committed
710
 * @binding_set: a #GtkBindingSet to skip an entry of
711 712 713
 * @keyval:      key value of binding to skip
 * @modifiers:   key modifier of binding to skip
 *
714 715 716
 * Install a binding on @binding_set which causes key lookups
 * to be aborted, to prevent bindings from lower priority sets
 * to be activated.
Matthias Clasen's avatar
Matthias Clasen committed
717 718
 *
 * Since: 2.12
Matthias Clasen's avatar
Matthias Clasen committed
719
 */
720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739
void
gtk_binding_entry_skip (GtkBindingSet  *binding_set,
                        guint           keyval,
                        GdkModifierType modifiers)
{
  GtkBindingEntry *entry;

  g_return_if_fail (binding_set != NULL);

  keyval = gdk_keyval_to_lower (keyval);
  modifiers = modifiers & BINDING_MOD_MASK ();

  entry = binding_ht_lookup_entry (binding_set, keyval, modifiers);
  if (entry)
    binding_entry_destroy (entry);

  entry = binding_entry_new (binding_set, keyval, modifiers);
  entry->marks_unbound = TRUE;
}

740 741
/**
 * gtk_binding_entry_remove:
Matthias Clasen's avatar
Matthias Clasen committed
742
 * @binding_set: a #GtkBindingSet to remove an entry of
743 744 745 746 747
 * @keyval:      key value of binding to remove
 * @modifiers:   key modifier of binding to remove
 *
 * Remove a binding previously installed via
 * gtk_binding_entry_add_signal() on @binding_set.
Matthias Clasen's avatar
Matthias Clasen committed
748
 */
Tim Janik's avatar
Tim Janik committed
749 750 751
void
gtk_binding_entry_remove (GtkBindingSet	 *binding_set,
			  guint		  keyval,
752
			  GdkModifierType modifiers)
Tim Janik's avatar
Tim Janik committed
753 754 755 756 757 758 759 760 761 762 763 764 765
{
  GtkBindingEntry *entry;
  
  g_return_if_fail (binding_set != NULL);
  
  keyval = gdk_keyval_to_lower (keyval);
  modifiers = modifiers & BINDING_MOD_MASK ();
  
  entry = binding_ht_lookup_entry (binding_set, keyval, modifiers);
  if (entry)
    binding_entry_destroy (entry);
}

766 767
/**
 * gtk_binding_entry_add_signall:
Matthias Clasen's avatar
Matthias Clasen committed
768
 * @binding_set:  a #GtkBindingSet to add a signal to
769 770 771 772 773
 * @keyval:       key value
 * @modifiers:    key modifier
 * @signal_name:  signal name to be bound
 * @binding_args: list of #GtkBindingArg signal arguments
 *
774 775
 * Override or install a new key binding for @keyval with @modifiers on
 * @binding_set.
Matthias Clasen's avatar
Matthias Clasen committed
776
 */
Tim Janik's avatar
Tim Janik committed
777 778
void
gtk_binding_entry_add_signall (GtkBindingSet  *binding_set,
779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794
                               guint	       keyval,
                               GdkModifierType modifiers,
                               const gchar    *signal_name,
                               GSList	      *binding_args)
{
  _gtk_binding_entry_add_signall (binding_set,
                                  keyval, modifiers,
                                  signal_name, binding_args);
}

void
_gtk_binding_entry_add_signall (GtkBindingSet  *binding_set,
                                guint	       keyval,
                                GdkModifierType modifiers,
                                const gchar    *signal_name,
                                GSList	      *binding_args)
Tim Janik's avatar
Tim Janik committed
795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821
{
  GtkBindingEntry *entry;
  GtkBindingSignal *signal, **signal_p;
  GSList *slist;
  guint n = 0;
  GtkBindingArg *arg;
  
  g_return_if_fail (binding_set != NULL);
  g_return_if_fail (signal_name != NULL);
  
  keyval = gdk_keyval_to_lower (keyval);
  modifiers = modifiers & BINDING_MOD_MASK ();
  
  signal = binding_signal_new (signal_name, g_slist_length (binding_args));
  
  arg = signal->args;
  for (slist = binding_args; slist; slist = slist->next)
    {
      GtkBindingArg *tmp_arg;
      
      tmp_arg = slist->data;
      if (!tmp_arg)
	{
	  g_warning ("gtk_binding_entry_add_signall(): arg[%u] is `NULL'", n);
	  binding_signal_free (signal);
	  return;
	}
Manish Singh's avatar
Manish Singh committed
822
      switch (G_TYPE_FUNDAMENTAL (tmp_arg->arg_type))
Tim Janik's avatar
Tim Janik committed
823
	{
Manish Singh's avatar
Manish Singh committed
824 825
	case  G_TYPE_LONG:
	  arg->arg_type = G_TYPE_LONG;
Tim Janik's avatar
Tim Janik committed
826 827
	  arg->d.long_data = tmp_arg->d.long_data;
	  break;
Manish Singh's avatar
Manish Singh committed
828 829
	case  G_TYPE_DOUBLE:
	  arg->arg_type = G_TYPE_DOUBLE;
Tim Janik's avatar
Tim Janik committed
830 831
	  arg->d.double_data = tmp_arg->d.double_data;
	  break;
Manish Singh's avatar
Manish Singh committed
832
	case  G_TYPE_STRING:
833
          if (tmp_arg->arg_type != GTK_TYPE_IDENTIFIER)
Manish Singh's avatar
Manish Singh committed
834
	    arg->arg_type = G_TYPE_STRING;
835 836 837 838
	  else
	    arg->arg_type = GTK_TYPE_IDENTIFIER;
	  arg->d.string_data = g_strdup (tmp_arg->d.string_data);
	  if (!arg->d.string_data)
Tim Janik's avatar
Tim Janik committed
839 840 841 842 843 844 845 846
	    {
	      g_warning ("gtk_binding_entry_add_signall(): value of `string' arg[%u] is `NULL'", n);
	      binding_signal_free (signal);
	      return;
	    }
	  break;
	default:
	  g_warning ("gtk_binding_entry_add_signall(): unsupported type `%s' for arg[%u]",
Manish Singh's avatar
Manish Singh committed
847
		     g_type_name (arg->arg_type), n);
Tim Janik's avatar
Tim Janik committed
848 849 850 851 852 853 854 855 856 857
	  binding_signal_free (signal);
	  return;
	}
      arg++;
      n++;
    }
  
  entry = binding_ht_lookup_entry (binding_set, keyval, modifiers);
  if (!entry)
    {
858
      gtk_binding_entry_clear_internal (binding_set, keyval, modifiers);
Tim Janik's avatar
Tim Janik committed
859 860 861 862 863 864 865 866
      entry = binding_ht_lookup_entry (binding_set, keyval, modifiers);
    }
  signal_p = &entry->signals;
  while (*signal_p)
    signal_p = &(*signal_p)->next;
  *signal_p = signal;
}

867 868
/**
 * gtk_binding_entry_add_signal:
Matthias Clasen's avatar
Matthias Clasen committed
869
 * @binding_set: a #GtkBindingSet to install an entry for
870 871 872 873
 * @keyval:      key value of binding to install
 * @modifiers:   key modifier of binding to install
 * @signal_name: signal to execute upon activation
 * @n_args:      number of arguments to @signal_name
Matthias Clasen's avatar
Matthias Clasen committed
874
 * @Varargs:     arguments to @signal_name
875 876
 *
 * Override or install a new key binding for @keyval with @modifiers on
Matthias Clasen's avatar
Matthias Clasen committed
877
 * @binding_set. When the binding is activated, @signal_name will be
878 879
 * emitted on the target widget, with @n_args @Varargs used as
 * arguments.
Matthias Clasen's avatar
Matthias Clasen committed
880
 */
Tim Janik's avatar
Tim Janik committed
881 882 883
void
gtk_binding_entry_add_signal (GtkBindingSet  *binding_set,
			      guint           keyval,
884
			      GdkModifierType modifiers,
Tim Janik's avatar
Tim Janik committed
885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901
			      const gchar    *signal_name,
			      guint           n_args,
			      ...)
{
  GSList *slist, *free_slist;
  va_list args;
  guint i;

  g_return_if_fail (binding_set != NULL);
  g_return_if_fail (signal_name != NULL);
  
  va_start (args, n_args);
  slist = NULL;
  for (i = 0; i < n_args; i++)
    {
      GtkBindingArg *arg;

902
      arg = g_slice_new0 (GtkBindingArg);
Tim Janik's avatar
Tim Janik committed
903 904
      slist = g_slist_prepend (slist, arg);

Michael Natterer's avatar
Michael Natterer committed
905
      arg->arg_type = va_arg (args, GType);
Manish Singh's avatar
Manish Singh committed
906
      switch (G_TYPE_FUNDAMENTAL (arg->arg_type))
Tim Janik's avatar
Tim Janik committed
907
	{
Manish Singh's avatar
Manish Singh committed
908 909 910 911 912 913 914 915
	case G_TYPE_CHAR:
	case G_TYPE_UCHAR:
	case G_TYPE_INT:
	case G_TYPE_UINT:
	case G_TYPE_BOOLEAN:
	case G_TYPE_ENUM:
	case G_TYPE_FLAGS:
	  arg->arg_type = G_TYPE_LONG;
Tim Janik's avatar
Tim Janik committed
916 917
	  arg->d.long_data = va_arg (args, gint);
	  break;
Manish Singh's avatar
Manish Singh committed
918 919 920
	case G_TYPE_LONG:
	case G_TYPE_ULONG:
	  arg->arg_type = G_TYPE_LONG;
Tim Janik's avatar
Tim Janik committed
921 922
	  arg->d.long_data = va_arg (args, glong);
	  break;
Manish Singh's avatar
Manish Singh committed
923 924 925
	case G_TYPE_FLOAT:
	case G_TYPE_DOUBLE:
	  arg->arg_type = G_TYPE_DOUBLE;
Tim Janik's avatar
Tim Janik committed
926 927
	  arg->d.double_data = va_arg (args, gdouble);
	  break;
Manish Singh's avatar
Manish Singh committed
928
	case G_TYPE_STRING:
929
	  if (arg->arg_type != GTK_TYPE_IDENTIFIER)
Manish Singh's avatar
Manish Singh committed
930
	    arg->arg_type = G_TYPE_STRING;
Tim Janik's avatar
Tim Janik committed
931 932
	  arg->d.string_data = va_arg (args, gchar*);
	  if (!arg->d.string_data)
Tim Janik's avatar
Tim Janik committed
933
	    {
934
	      g_warning ("gtk_binding_entry_add_signal(): type `%s' arg[%u] is `NULL'",
Manish Singh's avatar
Manish Singh committed
935
			 g_type_name (arg->arg_type),
936
			 i);
937
	      i += n_args + 1;
Tim Janik's avatar
Tim Janik committed
938 939 940 941
	    }
	  break;
	default:
	  g_warning ("gtk_binding_entry_add_signal(): unsupported type `%s' for arg[%u]",
Manish Singh's avatar
Manish Singh committed
942
		     g_type_name (arg->arg_type), i);
943
	  i += n_args + 1;
Tim Janik's avatar
Tim Janik committed
944 945 946 947 948
	  break;
	}
    }
  va_end (args);

949
  if (i == n_args || i == 0)
Tim Janik's avatar
Tim Janik committed
950 951
    {
      slist = g_slist_reverse (slist);
952
      _gtk_binding_entry_add_signall (binding_set, keyval, modifiers, signal_name, slist);
Tim Janik's avatar
Tim Janik committed
953 954 955 956 957
    }

  free_slist = slist;
  while (slist)
    {
958
      g_slice_free (GtkBindingArg, slist->data);
Tim Janik's avatar
Tim Janik committed
959 960 961 962 963
      slist = slist->next;
    }
  g_slist_free (free_slist);
}

964 965
/**
 * gtk_binding_set_add_path:
Matthias Clasen's avatar
Matthias Clasen committed
966
 * @binding_set:  a #GtkBindingSet to add a path to
967 968 969 970 971 972
 * @path_type:    path type the pattern applies to
 * @path_pattern: the actual match pattern
 * @priority:     binding priority
 *
 * This function is used internally by the GtkRC parsing mechanism to
 * assign match patterns to #GtkBindingSet structures.
Matthias Clasen's avatar
Matthias Clasen committed
973
 */
Tim Janik's avatar
Tim Janik committed
974 975 976 977 978 979
void
gtk_binding_set_add_path (GtkBindingSet	     *binding_set,
			  GtkPathType	      path_type,
			  const gchar	     *path_pattern,
			  GtkPathPriorityType priority)
{
980
  PatternSpec *pspec;
Tim Janik's avatar
Tim Janik committed
981 982 983 984 985
  GSList **slist_p, *slist;
  static guint seq_id = 0;
  
  g_return_if_fail (binding_set != NULL);
  g_return_if_fail (path_pattern != NULL);
986
  g_return_if_fail (priority <= GTK_PATH_PRIO_MASK);
Tim Janik's avatar
Tim Janik committed
987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006

  priority &= GTK_PATH_PRIO_MASK;
  
  switch (path_type)
    {
    case  GTK_PATH_WIDGET:
      slist_p = &binding_set->widget_path_pspecs;
      break;
    case  GTK_PATH_WIDGET_CLASS:
      slist_p = &binding_set->widget_class_pspecs;
      break;
    case  GTK_PATH_CLASS:
      slist_p = &binding_set->class_branch_pspecs;
      break;
    default:
      g_assert_not_reached ();
      slist_p = NULL;
      break;
    }
  
1007
  pspec = g_new (PatternSpec, 1);
1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019
  pspec->type = path_type;
  if (path_type == GTK_PATH_WIDGET_CLASS)
    {
      pspec->pspec = NULL;
      pspec->path = _gtk_rc_parse_widget_class_path (path_pattern);
    }
  else
    {
      pspec->pspec = g_pattern_spec_new (path_pattern);
      pspec->path = NULL;
    }
    
1020
  pspec->seq_id = priority << 28;
Tim Janik's avatar
Tim Janik committed
1021 1022 1023 1024 1025
  pspec->user_data = binding_set;
  
  slist = *slist_p;
  while (slist)
    {
1026
      PatternSpec *tmp_pspec;
Tim Janik's avatar
Tim Janik committed
1027 1028 1029 1030
      
      tmp_pspec = slist->data;
      slist = slist->next;
      
1031
      if (g_pattern_spec_equal (tmp_pspec->pspec, pspec->pspec))
Tim Janik's avatar
Tim Janik committed
1032
	{
1033 1034
	  GtkPathPriorityType lprio = tmp_pspec->seq_id >> 28;

1035
	  pattern_spec_free (pspec);
Tim Janik's avatar
Tim Janik committed
1036
	  pspec = NULL;
1037 1038 1039 1040 1041
	  if (lprio < priority)
	    {
	      tmp_pspec->seq_id &= 0x0fffffff;
	      tmp_pspec->seq_id |= priority << 28;
	    }
1042
	  break;
Tim Janik's avatar
Tim Janik committed
1043 1044 1045
	}
    }
  if (pspec)
1046 1047 1048 1049
    {
      pspec->seq_id |= seq_id++ & 0x0fffffff;
      *slist_p = g_slist_prepend (*slist_p, pspec);
    }
Tim Janik's avatar
Tim Janik committed
1050 1051
}

1052
static gboolean
Tim Janik's avatar
Tim Janik committed
1053 1054 1055
binding_match_activate (GSList          *pspec_list,
			GtkObject	*object,
			guint	         path_length,
1056
			gchar           *path,
1057 1058
			gchar           *path_reversed,
                        gboolean        *unbound)
Tim Janik's avatar
Tim Janik committed
1059 1060 1061
{
  GSList *slist;

1062 1063
  *unbound = FALSE;

Tim Janik's avatar
Tim Janik committed
1064 1065
  for (slist = pspec_list; slist; slist = slist->next)
    {
1066
      PatternSpec *pspec;
1067
      GtkBindingSet *binding_set;
Tim Janik's avatar
Tim Janik committed
1068

1069
      binding_set = NULL;
Tim Janik's avatar
Tim Janik committed
1070
      pspec = slist->data;
1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081
      
      if (pspec->type == GTK_PATH_WIDGET_CLASS)
        {
          if (_gtk_rc_match_widget_class (pspec->path, path_length, path, path_reversed))
	    binding_set = pspec->user_data;
        }
      else
        {
          if (g_pattern_match (pspec->pspec, path_length, path, path_reversed))
	    binding_set = pspec->user_data;
        }
Tim Janik's avatar
Tim Janik committed
1082

1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093
      if (binding_set)
        {
          if (binding_set->current->marks_unbound)
            {
              *unbound = TRUE;
              return FALSE;
            }

          if (gtk_binding_entry_activate (binding_set->current, object))
            return TRUE;
        }
Tim Janik's avatar
Tim Janik committed
1094 1095 1096 1097 1098 1099
    }

  return FALSE;
}

static gint
1100 1101
gtk_binding_pattern_compare (gconstpointer new_pattern,
			     gconstpointer existing_pattern)
Tim Janik's avatar
Tim Janik committed
1102
{
1103 1104
  register const PatternSpec *np  = new_pattern;
  register const PatternSpec *ep  = existing_pattern;
Tim Janik's avatar
Tim Janik committed
1105

1106 1107 1108 1109 1110
  /* walk the list as long as the existing patterns have
   * higher priorities.
   */

  return np->seq_id < ep->seq_id;
Tim Janik's avatar
Tim Janik committed
1111 1112
}

1113 1114 1115 1116
static GSList*
gtk_binding_entries_sort_patterns (GSList      *entries,
				   GtkPathType  path_id,
				   gboolean     is_release)
Tim Janik's avatar
Tim Janik committed
1117 1118
{
  GSList *patterns;
1119
  GSList *tmp_list;
Tim Janik's avatar
Tim Janik committed
1120 1121

  patterns = NULL;
1122 1123 1124 1125 1126 1127 1128 1129 1130
  for (tmp_list = entries; tmp_list; tmp_list = tmp_list->next)
    {
      GtkBindingEntry *entry = tmp_list->data;
      GtkBindingSet *binding_set;

      binding_set = entry->binding_set;
      binding_set->current = NULL;
    }
  
1131
  for (; entries; entries = entries->next)
Tim Janik's avatar
Tim Janik committed
1132
    {
1133 1134
      GtkBindingEntry *entry = entries->data;
      GtkBindingSet *binding_set;
Tim Janik's avatar
Tim Janik committed
1135 1136
      GSList *slist = NULL;

1137 1138 1139 1140
      if (is_release != ((entry->modifiers & GDK_RELEASE_MASK) != 0))
	continue;

      binding_set = entry->binding_set;
1141 1142 1143

      if (binding_set->current)
	continue;
1144
      binding_set->current = entry;
Tim Janik's avatar
Tim Janik committed
1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160

      switch (path_id)
	{
	case GTK_PATH_WIDGET:
	  slist = binding_set->widget_path_pspecs;
	  break;
	case GTK_PATH_WIDGET_CLASS:
	  slist = binding_set->widget_class_pspecs;
	  break;
	case GTK_PATH_CLASS:
	  slist = binding_set->class_branch_pspecs;
	  break;
	}

      for (; slist; slist = slist->next)
	{
1161
	  PatternSpec *pspec;
Tim Janik's avatar
Tim Janik committed
1162 1163 1164 1165 1166 1167 1168 1169 1170

	  pspec = slist->data;
	  patterns = g_slist_insert_sorted (patterns, pspec, gtk_binding_pattern_compare);
	}
    }

  return patterns;
}

1171 1172 1173 1174
static gboolean
gtk_bindings_activate_list (GtkObject *object,
			    GSList    *entries,
			    gboolean   is_release)
Tim Janik's avatar
Tim Janik committed
1175
{
1176
  GtkWidget *widget = GTK_WIDGET (object);
Tim Janik's avatar
Tim Janik committed
1177 1178 1179 1180 1181 1182 1183 1184 1185 1186
  gboolean handled = FALSE;

  if (!entries)
    return FALSE;

  if (!handled)
    {
      guint path_length;
      gchar *path, *path_reversed;
      GSList *patterns;
1187
      gboolean unbound;
Tim Janik's avatar
Tim Janik committed
1188 1189

      gtk_widget_path (widget, &path_length, &path, &path_reversed);
1190
      patterns = gtk_binding_entries_sort_patterns (entries, GTK_PATH_WIDGET, is_release);
1191
      handled = binding_match_activate (patterns, object, path_length, path, path_reversed, &unbound);
Tim Janik's avatar
Tim Janik committed
1192 1193 1194
      g_slist_free (patterns);
      g_free (path);
      g_free (path_reversed);
1195 1196 1197

      if (unbound)
        return FALSE;
Tim Janik's avatar
Tim Janik committed
1198 1199 1200 1201 1202 1203 1204
    }

  if (!handled)
    {
      guint path_length;
      gchar *path, *path_reversed;
      GSList *patterns;
1205
      gboolean unbound;
Tim Janik's avatar
Tim Janik committed
1206 1207

      gtk_widget_class_path (widget, &path_length, &path, &path_reversed);
1208
      patterns = gtk_binding_entries_sort_patterns (entries, GTK_PATH_WIDGET_CLASS, is_release);
1209
      handled = binding_match_activate (patterns, object, path_length, path, path_reversed, &unbound);
Tim Janik's avatar
Tim Janik committed
1210 1211 1212
      g_slist_free (patterns);
      g_free (path);
      g_free (path_reversed);
1213 1214 1215

      if (unbound)
        return FALSE;
Tim Janik's avatar
Tim Janik committed
1216 1217 1218 1219 1220
    }

  if (!handled)
    {
      GSList *patterns;
Manish Singh's avatar
Manish Singh committed
1221
      GType class_type;
1222 1223
      gboolean unbound = FALSE;

1224
      patterns = gtk_binding_entries_sort_patterns (entries, GTK_PATH_CLASS, is_release);
Manish Singh's avatar
Manish Singh committed
1225
      class_type = G_TYPE_FROM_INSTANCE (object);
Tim Janik's avatar
Tim Janik committed
1226 1227 1228
      while (class_type && !handled)
	{
	  guint path_length;
1229
	  gchar *path;
1230
	  gchar *path_reversed;
1231

1232
	  path = g_strdup (g_type_name (class_type));
Tim Janik's avatar
Tim Janik committed
1233 1234 1235
	  path_reversed = g_strdup (path);
	  g_strreverse (path_reversed);
	  path_length = strlen (path);
1236
	  handled = binding_match_activate (patterns, object, path_length, path, path_reversed, &unbound);
1237
	  g_free (path);
Tim Janik's avatar
Tim Janik committed
1238 1239
	  g_free (path_reversed);

1240 1241 1242
          if (unbound)
            break;

Manish Singh's avatar
Manish Singh committed
1243
	  class_type = g_type_parent (class_type);
Tim Janik's avatar
Tim Janik committed
1244 1245
	}
      g_slist_free (patterns);
1246 1247 1248

      if (unbound)
        return FALSE;
Tim Janik's avatar
Tim Janik committed
1249 1250 1251 1252 1253
    }

  return handled;
}

1254 1255 1256 1257 1258 1259 1260 1261 1262 1263
/**
 * gtk_bindings_activate:
 * @object: object to activate when binding found
 * @keyval: key value of the binding
 * @modifiers: key modifier of the binding
 *
 * Find a key binding matching @keyval and @modifiers and activate the
 * binding on @object.
 *
 * Return value: %TRUE if a binding was found and activated
Matthias Clasen's avatar
Matthias Clasen committed
1264
 */
1265
gboolean
Matthias Clasen's avatar
Matthias Clasen committed
1266 1267 1268
gtk_bindings_activate (GtkObject       *object,
		       guint	        keyval,
		       GdkModifierType  modifiers)
1269 1270
{
  GSList *entries = NULL;
1271
  GdkDisplay *display;
1272 1273 1274 1275 1276 1277 1278 1279 1280
  GtkKeyHash *key_hash;
  gboolean handled = FALSE;
  gboolean is_release;

  g_return_val_if_fail (GTK_IS_OBJECT (object), FALSE);

  if (!GTK_IS_WIDGET (object))
    return FALSE;

1281
  is_release = (modifiers & GDK_RELEASE_MASK) != 0;
1282 1283
  modifiers = modifiers & BINDING_MOD_MASK () & ~GDK_RELEASE_MASK;

1284 1285 1286
  display = gtk_widget_get_display (GTK_WIDGET (object));
  key_hash = binding_key_hash_for_keymap (gdk_keymap_get_for_display (display));
  
1287 1288 1289 1290 1291 1292 1293 1294 1295 1296
  entries = _gtk_key_hash_lookup_keyval (key_hash, keyval, modifiers);

  handled = gtk_bindings_activate_list (object, entries, is_release);

  g_slist_free (entries);

  return handled;
}

/**
1297
 * gtk_bindings_activate_event:
1298 1299 1300 1301 1302 1303 1304
 * @object: a #GtkObject (generally must be a widget)
 * @event: a #GdkEventKey
 * 
 * Looks up key bindings for @object to find one matching
 * @event, and if one was found, activate it.
 * 
 * Return value: %TRUE if a matching key binding was found
1305 1306
 *
 * Since: 2.4
Matthias Clasen's avatar
Matthias Clasen committed
1307
 */
1308
gboolean
Matthias Clasen's avatar
Matthias Clasen committed
1309 1310
gtk_bindings_activate_event (GtkObject   *object,
                             GdkEventKey *event)
1311 1312
{
  GSList *entries = NULL;
1313
  GdkDisplay *display;
1314 1315 1316 1317 1318 1319 1320 1321
  GtkKeyHash *key_hash;
  gboolean handled = FALSE;

  g_return_val_if_fail (GTK_IS_OBJECT (object), FALSE);

  if (!GTK_IS_WIDGET (object))
    return FALSE;

1322 1323 1324
  display = gtk_widget_get_display (GTK_WIDGET (object));
  key_hash = binding_key_hash_for_keymap (gdk_keymap_get_for_display (display));

1325 1326
  entries = _gtk_key_hash_lookup (key_hash,
				  event->hardware_keycode,
1327 1328
				  event->state,
				  BINDING_MOD_MASK () & ~GDK_RELEASE_MASK,
1329 1330 1331 1332 1333 1334 1335 1336 1337 1338
				  event->group);
  
  handled = gtk_bindings_activate_list (object, entries,
					event->type == GDK_KEY_RELEASE);

  g_slist_free (entries);

  return handled;
}

1339 1340 1341 1342
static guint
gtk_binding_parse_signal (GScanner       *scanner,
			  GtkBindingSet  *binding_set,
			  guint		  keyval,
1343
			  GdkModifierType modifiers)
1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389
{
  gchar *signal;
  guint expected_token = 0;
  GSList *args;
  GSList *slist;
  gboolean done;
  gboolean negate;
  gboolean need_arg;
  gboolean seen_comma;

  g_return_val_if_fail (scanner != NULL, G_TOKEN_ERROR);
  
  g_scanner_get_next_token (scanner);
  if (scanner->token != G_TOKEN_STRING)
    return G_TOKEN_STRING;
  g_scanner_peek_next_token (scanner);
  if (scanner->next_token != '(')
    {
      g_scanner_get_next_token (scanner);
      return '(';
    }
  signal = g_strdup (scanner->value.v_string);
  g_scanner_get_next_token (scanner);

  negate = FALSE;
  args = NULL;
  done = FALSE;
  need_arg = TRUE;
  seen_comma = FALSE;
  scanner->config->scan_symbols = FALSE;
  do
    {
      if (need_arg)
	expected_token = G_TOKEN_INT;
      else
	expected_token = ')';
      g_scanner_get_next_token (scanner);
      switch (scanner->token)
	{
	  GtkBindingArg *arg;

	case G_TOKEN_FLOAT:
	  if (need_arg)
	    {
	      need_arg = FALSE;
	      arg = g_new (GtkBindingArg, 1);
Manish Singh's avatar
Manish Singh committed
1390
	      arg->arg_type = G_TYPE_DOUBLE;
1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406
	      arg->d.double_data = scanner->value.v_float;
	      if (negate)
		{
		  arg->d.double_data = - arg->d.double_data;
		  negate = FALSE;
		}
	      args = g_slist_prepend (args, arg);
	    }
	  else
	    done = TRUE;
	  break;
	case G_TOKEN_INT:
	  if (need_arg)
	    {
	      need_arg = FALSE;
	      arg = g_new (GtkBindingArg, 1);
Manish Singh's avatar
Manish Singh committed
1407
	      arg->arg_type = G_TYPE_LONG;
1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423
	      arg->d.long_data = scanner->value.v_int;
	      if (negate)
		{
		  arg->d.long_data = - arg->d.long_data;
		  negate = FALSE;
		}
	      args = g_slist_prepend (args, arg);
	    }
          else
	    done = TRUE;
	  break;
	case G_TOKEN_STRING:
	  if (need_arg && !negate)
	    {
	      need_arg = FALSE;
	      arg = g_new (GtkBindingArg, 1);
Manish Singh's avatar
Manish Singh committed
1424
	      arg->arg_type = G_TYPE_STRING;
1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464
	      arg->d.string_data = g_strdup (scanner->value.v_string);
	      args = g_slist_prepend (args, arg);
	    }
	  else
	    done = TRUE;
	  break;
	case G_TOKEN_IDENTIFIER:
	  if (need_arg && !negate)
	    {
	      need_arg = FALSE;
	      arg = g_new (GtkBindingArg, 1);
	      arg->arg_type = GTK_TYPE_IDENTIFIER;
	      arg->d.string_data = g_strdup (scanner->value.v_identifier);
	      args = g_slist_prepend (args, arg);
	    }
	  else
	    done = TRUE;
	  break;
	case '-':
	  if (!need_arg)
	    done = TRUE;
	  else if (negate)
	    {
	      expected_token = G_TOKEN_INT;
	      done = TRUE;
	    }
	  else
	    negate = TRUE;
	  break;
	case ',':
	  seen_comma = TRUE;
	  if (need_arg)
	    done = TRUE;
	  else
	    need_arg = TRUE;
	  break;
	case ')':
	  if (!(need_arg && seen_comma) && !negate)
	    {
	      args = g_slist_reverse (args);
1465 1466 1467 1468 1469
	      _gtk_binding_entry_add_signall (binding_set,
                                              keyval,
                                              modifiers,
                                              signal,
                                              args);
1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486
	      expected_token = G_TOKEN_NONE;
	    }
	  done = TRUE;
	  break;
	default:
	  done = TRUE;
	  break;
	}
    }
  while (!done);
  scanner->config->scan_symbols = TRUE;
  
  for (slist = args; slist; slist = slist->next)
    {
      GtkBindingArg *arg;

      arg = slist->data;
Manish Singh's avatar
Manish Singh committed
1487
      if (G_TYPE_FUNDAMENTAL (arg->arg_type) == G_TYPE_STRING)
1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501
	g_free (arg->d.string_data);
      g_free (arg);
    }
  g_slist_free (args);
  g_free (signal);

  return expected_token;
}

static inline guint
gtk_binding_parse_bind (GScanner       *scanner,
			GtkBindingSet  *binding_set)
{
  guint keyval = 0;
1502
  GdkModifierType modifiers = 0;
1503
  gboolean unbind = FALSE;
1504 1505 1506 1507

  g_return_val_if_fail (scanner != NULL, G_TOKEN_ERROR);
  
  g_scanner_get_next_token (scanner);
1508 1509
  if (scanner->token != GTK_RC_TOKEN_BIND &&
      scanner->token != GTK_RC_TOKEN_UNBIND)
1510
    return GTK_RC_TOKEN_BIND;
1511
  unbind = scanner->token == GTK_RC_TOKEN_UNBIND;
1512 1513 1514 1515 1516 1517 1518 1519
  g_scanner_get_next_token (scanner);
  if (scanner->token != G_TOKEN_STRING)
    return G_TOKEN_STRING;
  gtk_accelerator_parse (scanner->value.v_string, &keyval, &modifiers);
  modifiers &= BINDING_MOD_MASK ();
  if (keyval == 0)
    return G_TOKEN_STRING;

1520 1521 1522 1523 1524 1525
  if (unbind)
    {
      gtk_binding_entry_skip (binding_set, keyval, modifiers);
      return G_TOKEN_NONE;
    }

1526
  g_scanner_get_next_token (scanner);
1527

1528 1529 1530
  if (scanner->token != '{')
    return '{';

1531 1532
  gtk_binding_entry_clear_internal (binding_set, keyval, modifiers);

1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558
  g_scanner_peek_next_token (scanner);
  while (scanner->next_token != '}')
    {
      switch (scanner->next_token)
	{
	  guint expected_token;

	case G_TOKEN_STRING:
	  expected_token = gtk_binding_parse_signal (scanner,
						     binding_set,
						     keyval,
						     modifiers);
	  if (expected_token != G_TOKEN_NONE)
	    return expected_token;
	  break;
	default:
	  g_scanner_get_next_token (scanner);
	  return '}';
	}
      g_scanner_peek_next_token (scanner);
    }
  g_scanner_get_next_token (scanner);

  return G_TOKEN_NONE;
}

1559 1560
guint
_gtk_binding_parse_binding (GScanner *scanner)
1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583
{
  gchar *name;
  GtkBindingSet *binding_set;

  g_return_val_if_fail (scanner != NULL, G_TOKEN_ERROR);

  g_scanner_get_next_token (scanner);
  if (scanner->token != GTK_RC_TOKEN_BINDING)
    return GTK_RC_TOKEN_BINDING;
  g_scanner_get_next_token (scanner);
  if (scanner->token != G_TOKEN_STRING)
    return G_TOKEN_STRING;
  name = g_strdup (scanner->value.v_string);

  g_scanner_get_next_token (scanner);
  if (scanner->token != '{')
    {
      g_free (name);
      return G_TOKEN_STRING;
    }

  binding_set = gtk_binding_set_find (name);
  if (!binding_set)
1584 1585 1586 1587
    {
      binding_set = gtk_binding_set_new (name);
      binding_set->parsed = 1;
    }
1588 1589 1590 1591 1592 1593 1594 1595 1596 1597
  g_free (name);

  g_scanner_peek_next_token (scanner);
  while (scanner->next_token != '}')
    {
      switch (scanner->next_token)
	{
	  guint expected_token;

	case GTK_RC_TOKEN_BIND:
1598
	case GTK_RC_TOKEN_UNBIND:
1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612
	  expected_token = gtk_binding_parse_bind (scanner, binding_set);
	  if (expected_token != G_TOKEN_NONE)
	    return expected_token;
	  break;
	default:
	  g_scanner_get_next_token (scanner);
	  return '}';
	}
      g_scanner_peek_next_token (scanner);
    }
  g_scanner_get_next_token (scanner);

  return G_TOKEN_NONE;
}
1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624

static void
free_pattern_specs (GSList *pattern_specs)
{
  GSList *slist;

  for (slist = pattern_specs; slist; slist = slist->next)
    {
      PatternSpec *pspec;

      pspec = slist->data;

1625
      pattern_spec_free (pspec);
1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653
    }

  g_slist_free (pattern_specs);
}

static void
binding_set_delete (GtkBindingSet *binding_set)
{
  GtkBindingEntry *entry, *next;

  entry = binding_set->entries;
  while (entry)
    {
      next = entry->set_next;
      binding_entry_destroy (entry);
      entry = next;
    }
  
  free_pattern_specs (binding_set->widget_path_pspecs);
  free_pattern_specs (binding_set->widget_class_pspecs);
  free_pattern_specs (binding_set->class_branch_pspecs);

  g_free (binding_set);
}

/**
 * _gtk_binding_reset_parsed:
 * 
Matthias Clasen's avatar
Matthias Clasen committed
1654 1655
 * Remove all binding sets that were added by gtk_binding_parse_binding().
 */
1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677
void
_gtk_binding_reset_parsed (void)
{
  GSList *slist, *next;
  
  slist = binding_set_list;
  while (slist)
    {
      GtkBindingSet *binding_set;

      binding_set = slist->data;
      next = slist->next;

      if (binding_set->parsed)
	{
	  binding_set_list = g_slist_delete_link (binding_set_list, slist);
	  binding_set_delete (binding_set);
	}

      slist = next;
    }
}