Pileus Git - ~andy/gtk/blob - gtk/gtkcellrendereraccel.c

   1 /* gtkcellrendereraccel.h
   2  * Copyright (C) 2000  Red Hat, Inc.,  Jonathan Blandford <jrb@redhat.com>
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Library General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 #include "config.h"
  21 #include "gtkintl.h"
  22 #include "gtkaccelgroup.h"
  23 #include "gtkmarshalers.h"
  24 #include "gtkcellrendereraccel.h"
  25 #include "gtklabel.h"
  26 #include "gtkeventbox.h"
  27 #include "gtkprivate.h"
  28 #include "gdk/gdkkeysyms.h"
  29 #include "gtkalias.h"
  30
  31
  32 static void gtk_cell_renderer_accel_get_property (GObject         *object,
  33                                                   guint            param_id,
  34                                                   GValue          *value,
  35                                                   GParamSpec      *pspec);
  36 static void gtk_cell_renderer_accel_set_property (GObject         *object,
  37                                                   guint            param_id,
  38                                                   const GValue    *value,
  39                                                   GParamSpec      *pspec);
  40 static void gtk_cell_renderer_accel_get_size     (GtkCellRenderer *cell,
  41                                                   GtkWidget       *widget,
  42                                                   GdkRectangle    *cell_area,
  43                                                   gint            *x_offset,
  44                                                   gint            *y_offset,
  45                                                   gint            *width,
  46                                                   gint            *height);
  47 static GtkCellEditable *
  48            gtk_cell_renderer_accel_start_editing (GtkCellRenderer *cell,
  49                                                   GdkEvent        *event,
  50                                                   GtkWidget       *widget,
  51                                                   const gchar     *path,
  52                                                   GdkRectangle    *background_area,
  53                                                   GdkRectangle    *cell_area,
  54                                                   GtkCellRendererState flags);
  55 static gchar *convert_keysym_state_to_string     (GtkCellRendererAccel *accel,
  56                                                   guint                 keysym,
  57                                                   GdkModifierType       mask,
  58                                                   guint                 keycode);
  59
  60 enum {
  61   ACCEL_EDITED,
  62   ACCEL_CLEARED,
  63   LAST_SIGNAL
  64 };
  65
  66 enum {
  67   PROP_0,
  68   PROP_ACCEL_KEY,
  69   PROP_ACCEL_MODS,
  70   PROP_KEYCODE,
  71   PROP_ACCEL_MODE
  72 };
  73
  74 static guint signals[LAST_SIGNAL] = { 0 };
  75
  76 G_DEFINE_TYPE (GtkCellRendererAccel, gtk_cell_renderer_accel, GTK_TYPE_CELL_RENDERER_TEXT)
  77
  78 static void
  79 gtk_cell_renderer_accel_init (GtkCellRendererAccel *cell_accel)
  80 {
  81   gchar *text;
  82
  83   text = convert_keysym_state_to_string (cell_accel, 0, 0, 0);
  84   g_object_set (cell_accel, "text", text, NULL);
  85   g_free (text);
  86 }
  87
  88 static void
  89 gtk_cell_renderer_accel_class_init (GtkCellRendererAccelClass *cell_accel_class)
  90 {
  91   GObjectClass *object_class;
  92   GtkCellRendererClass *cell_renderer_class;
  93
  94   object_class = G_OBJECT_CLASS (cell_accel_class);
  95   cell_renderer_class = GTK_CELL_RENDERER_CLASS (cell_accel_class);
  96
  97   object_class->set_property = gtk_cell_renderer_accel_set_property;
  98   object_class->get_property = gtk_cell_renderer_accel_get_property;
  99
 100   cell_renderer_class->get_size      = gtk_cell_renderer_accel_get_size;
 101   cell_renderer_class->start_editing = gtk_cell_renderer_accel_start_editing;
 102
 103   /**
 104    * GtkCellRendererAccel:accel-key:
 105    *
 106    * The keyval of the accelerator.
 107    *
 108    * Since: 2.10
 109    */
 110   g_object_class_install_property (object_class,
 111                                    PROP_ACCEL_KEY,
 112                                    g_param_spec_uint ("accel-key",
 113                                                      P_("Accelerator key"),
 114                                                      P_("The keyval of the accelerator"),
 115                                                       0,
 116                                                       G_MAXINT,
 117                                                       0,
 118                                                       GTK_PARAM_READWRITE));
 119
 120   /**
 121    * GtkCellRendererAccel:accel-mods:
 122    *
 123    * The modifier mask of the accelerator.
 124    *
 125    * Since: 2.10
 126    */
 127   g_object_class_install_property (object_class,
 128                                    PROP_ACCEL_MODS,
 129                                    g_param_spec_flags ("accel-mods",
 130                                                        P_("Accelerator modifiers"),
 131                                                        P_("The modifier mask of the accelerator"),
 132                                                        GDK_TYPE_MODIFIER_TYPE,
 133                                                        0,
 134                                                        GTK_PARAM_READWRITE));
 135
 136   /**
 137    * GtkCellRendererAccel:keycode:
 138    *
 139    * The hardware keycode of the accelerator. Note that the hardware keycode is
 140    * only relevant if the key does not have a keyval. Normally, the keyboard
 141    * configuration should assign keyvals to all keys.
 142    *
 143    * Since: 2.10
 144    */
 145   g_object_class_install_property (object_class,
 146                                    PROP_KEYCODE,
 147                                    g_param_spec_uint ("keycode",
 148                                                       P_("Accelerator keycode"),
 149                                                       P_("The hardware keycode of the accelerator"),
 150                                                       0,
 151                                                       G_MAXINT,
 152                                                       0,
 153                                                       GTK_PARAM_READWRITE));
 154
 155   /**
 156    * GtkCellRendererAccel:accel-mode:
 157    *
 158    * Determines if the edited accelerators are GTK+ accelerators. If
 159    * they are, consumed modifiers are suppressed, only accelerators
 160    * accepted by GTK+ are allowed, and the accelerators are rendered
 161    * in the same way as they are in menus.
 162    *
 163    * Since: 2.10
 164    */
 165   g_object_class_install_property (object_class,
 166                                    PROP_ACCEL_MODE,
 167                                    g_param_spec_enum ("accel-mode",
 168                                                       P_("Accelerator Mode"),
 169                                                       P_("The type of accelerators"),
 170                                                       GTK_TYPE_CELL_RENDERER_ACCEL_MODE,
 171                                                       GTK_CELL_RENDERER_ACCEL_MODE_GTK,
 172                                                       GTK_PARAM_READWRITE));
 173
 174   /**
 175    * GtkCellRendererAccel::accel-edited:
 176    * @accel: the object reveiving the signal
 177    * @path_string: the path identifying the row of the edited cell
 178    * @accel_key: the new accelerator keyval
 179    * @accel_mods: the new acclerator modifier mask
 180    * @hardware_keycode: the keycode of the new accelerator
 181    *
 182    * Gets emitted when the user has selected a new accelerator.
 183    *
 184    * Since: 2.10
 185    */
 186   signals[ACCEL_EDITED] = g_signal_new (I_("accel-edited"),
 187                                         GTK_TYPE_CELL_RENDERER_ACCEL,
 188                                         G_SIGNAL_RUN_LAST,
 189                                         G_STRUCT_OFFSET (GtkCellRendererAccelClass, accel_edited),
 190                                         NULL, NULL,
 191                                         _gtk_marshal_VOID__STRING_UINT_FLAGS_UINT,
 192                                         G_TYPE_NONE, 4,
 193                                         G_TYPE_STRING,
 194                                         G_TYPE_UINT,
 195                                         GDK_TYPE_MODIFIER_TYPE,
 196                                         G_TYPE_UINT);
 197
 198   /**
 199    * GtkCellRendererAccel::accel-cleared:
 200    * @accel: the object reveiving the signal
 201    * @path_string: the path identifying the row of the edited cell
 202    *
 203    * Gets emitted when the user has removed the accelerator.
 204    *
 205    * Since: 2.10
 206    */
 207   signals[ACCEL_CLEARED] = g_signal_new (I_("accel-cleared"),
 208                                          GTK_TYPE_CELL_RENDERER_ACCEL,
 209                                          G_SIGNAL_RUN_LAST,
 210                                          G_STRUCT_OFFSET (GtkCellRendererAccelClass, accel_cleared),
 211                                          NULL, NULL,
 212                                          g_cclosure_marshal_VOID__STRING,
 213                                          G_TYPE_NONE, 1,
 214                                          G_TYPE_STRING);
 215 }
 216
 217
 218 /**
 219  * gtk_cell_renderer_accel_new:
 220  *
 221  * Creates a new #GtkCellRendererAccel.
 222  *
 223  * Returns: the new cell renderer
 224  *
 225  * Since: 2.10
 226  */
 227 GtkCellRenderer *
 228 gtk_cell_renderer_accel_new (void)
 229 {
 230   return g_object_new (GTK_TYPE_CELL_RENDERER_ACCEL, NULL);
 231 }
 232
 233 static gchar *
 234 convert_keysym_state_to_string (GtkCellRendererAccel *accel,
 235                                 guint                 keysym,
 236                                 GdkModifierType       mask,
 237                                 guint                 keycode)
 238 {
 239   if (keysym == 0 && keycode == 0)
 240     /* This label is displayed in a treeview cell displaying
 241      * a disabled accelerator key combination.
 242      */
 243     return g_strdup (C_("Accelerator", "Disabled"));
 244   else
 245     {
 246       if (accel->accel_mode == GTK_CELL_RENDERER_ACCEL_MODE_GTK)
 247         return gtk_accelerator_get_label (keysym, mask);
 248       else
 249         {
 250           gchar *name;
 251
 252           name = gtk_accelerator_get_label (keysym, mask);
 253           if (name == NULL)
 254             name = gtk_accelerator_name (keysym, mask);
 255
 256           if (keysym == 0)
 257             {
 258               gchar *tmp;
 259
 260               tmp = name;
 261               name = g_strdup_printf ("%s0x%02x", tmp, keycode);
 262               g_free (tmp);
 263             }
 264
 265           return name;
 266         }
 267     }
 268 }
 269
 270 static void
 271 gtk_cell_renderer_accel_get_property  (GObject    *object,
 272                                        guint       param_id,
 273                                        GValue     *value,
 274                                        GParamSpec *pspec)
 275 {
 276   GtkCellRendererAccel *accel = GTK_CELL_RENDERER_ACCEL (object);
 277
 278   switch (param_id)
 279     {
 280     case PROP_ACCEL_KEY:
 281       g_value_set_uint (value, accel->accel_key);
 282       break;
 283
 284     case PROP_ACCEL_MODS:
 285       g_value_set_flags (value, accel->accel_mods);
 286       break;
 287
 288     case PROP_KEYCODE:
 289       g_value_set_uint (value, accel->keycode);
 290       break;
 291
 292     case PROP_ACCEL_MODE:
 293       g_value_set_enum (value, accel->accel_mode);
 294       break;
 295
 296     default:
 297       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
 298     }
 299 }
 300
 301 static void
 302 gtk_cell_renderer_accel_set_property  (GObject      *object,
 303                                        guint         param_id,
 304                                        const GValue *value,
 305                                        GParamSpec   *pspec)
 306 {
 307   GtkCellRendererAccel *accel = GTK_CELL_RENDERER_ACCEL (object);
 308   gboolean changed = FALSE;
 309
 310   switch (param_id)
 311     {
 312     case PROP_ACCEL_KEY:
 313       {
 314         guint accel_key = g_value_get_uint (value);
 315
 316         if (accel->accel_key != accel_key)
 317           {
 318             accel->accel_key = accel_key;
 319             changed = TRUE;
 320           }
 321       }
 322       break;
 323
 324     case PROP_ACCEL_MODS:
 325       {
 326         guint accel_mods = g_value_get_flags (value);
 327
 328         if (accel->accel_mods != accel_mods)
 329           {
 330             accel->accel_mods = accel_mods;
 331             changed = TRUE;
 332           }
 333       }
 334       break;
 335     case PROP_KEYCODE:
 336       {
 337         guint keycode = g_value_get_uint (value);
 338
 339         if (accel->keycode != keycode)
 340           {
 341             accel->keycode = keycode;
 342             changed = TRUE;
 343           }
 344       }
 345       break;
 346
 347     case PROP_ACCEL_MODE:
 348       accel->accel_mode = g_value_get_enum (value);
 349       break;
 350
 351     default:
 352       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
 353     }
 354
 355   if (changed)
 356     {
 357       gchar *text;
 358
 359       text = convert_keysym_state_to_string (accel, accel->accel_key, accel->accel_mods, accel->keycode);
 360       g_object_set (accel, "text", text, NULL);
 361       g_free (text);
 362     }
 363 }
 364
 365 static void
 366 gtk_cell_renderer_accel_get_size (GtkCellRenderer *cell,
 367                                   GtkWidget       *widget,
 368                                   GdkRectangle    *cell_area,
 369                                   gint            *x_offset,
 370                                   gint            *y_offset,
 371                                   gint            *width,
 372                                   gint            *height)
 373
 374 {
 375   GtkCellRendererAccel *accel = (GtkCellRendererAccel *) cell;
 376   GtkRequisition requisition;
 377
 378   if (accel->sizing_label == NULL)
 379     accel->sizing_label = gtk_label_new (_("New accelerator..."));
 380
 381   gtk_widget_size_request (accel->sizing_label, &requisition);
 382
 383   GTK_CELL_RENDERER_CLASS (gtk_cell_renderer_accel_parent_class)->get_size (cell, widget, cell_area,
 384                                                                             x_offset, y_offset, width, height);
 385
 386   /* FIXME: need to take the cell_area et al. into account */
 387   if (width)
 388     *width = MAX (*width, requisition.width);
 389   if (height)
 390     *height = MAX (*height, requisition.height);
 391 }
 392
 393 static gboolean
 394 grab_key_callback (GtkWidget            *widget,
 395                    GdkEventKey          *event,
 396                    GtkCellRendererAccel *accel)
 397 {
 398   GdkModifierType accel_mods = 0;
 399   guint accel_key;
 400   gchar *path;
 401   gboolean edited;
 402   gboolean cleared;
 403   GdkModifierType consumed_modifiers;
 404   GdkDisplay *display;
 405
 406   display = gtk_widget_get_display (widget);
 407
 408   if (event->is_modifier)
 409     return TRUE;
 410
 411   edited = FALSE;
 412   cleared = FALSE;
 413
 414   gdk_keymap_translate_keyboard_state (gdk_keymap_get_for_display (display),
 415                                        event->hardware_keycode,
 416                                        event->state,
 417                                        event->group,
 418                                        NULL, NULL, NULL, &consumed_modifiers);
 419
 420   accel_key = gdk_keyval_to_lower (event->keyval);
 421   if (accel_key == GDK_ISO_Left_Tab)
 422     accel_key = GDK_Tab;
 423
 424   accel_mods = event->state & gtk_accelerator_get_default_mod_mask ();
 425
 426   /* Filter consumed modifiers
 427    */
 428   if (accel->accel_mode == GTK_CELL_RENDERER_ACCEL_MODE_GTK)
 429     accel_mods &= ~consumed_modifiers;
 430
 431   /* Put shift back if it changed the case of the key, not otherwise.
 432    */
 433   if (accel_key != event->keyval)
 434     accel_mods |= GDK_SHIFT_MASK;
 435
 436   if (accel_mods == 0)
 437     {
 438       switch (event->keyval)
 439         {
 440         case GDK_Escape:
 441           goto out; /* cancel */
 442         case GDK_BackSpace:
 443           /* clear the accelerator on Backspace */
 444           cleared = TRUE;
 445           goto out;
 446         default:
 447           break;
 448         }
 449     }
 450
 451   if (accel->accel_mode == GTK_CELL_RENDERER_ACCEL_MODE_GTK)
 452     {
 453       if (!gtk_accelerator_valid (accel_key, accel_mods))
 454         {
 455           gtk_widget_error_bell (widget);
 456
 457           return TRUE;
 458         }
 459     }
 460
 461   edited = TRUE;
 462
 463  out:
 464   gdk_display_keyboard_ungrab (display, event->time);
 465   gdk_display_pointer_ungrab (display, event->time);
 466
 467   path = g_strdup (g_object_get_data (G_OBJECT (accel->edit_widget), "gtk-cell-renderer-text"));
 468
 469   gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (accel->edit_widget));
 470   gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (accel->edit_widget));
 471   accel->edit_widget = NULL;
 472   accel->grab_widget = NULL;
 473
 474   if (edited)
 475     g_signal_emit (accel, signals[ACCEL_EDITED], 0, path,
 476                    accel_key, accel_mods, event->hardware_keycode);
 477   else if (cleared)
 478     g_signal_emit (accel, signals[ACCEL_CLEARED], 0, path);
 479
 480   g_free (path);
 481
 482   return TRUE;
 483 }
 484
 485 static void
 486 ungrab_stuff (GtkWidget            *widget,
 487               GtkCellRendererAccel *accel)
 488 {
 489   GdkDisplay *display = gtk_widget_get_display (widget);
 490
 491   gdk_display_keyboard_ungrab (display, GDK_CURRENT_TIME);
 492   gdk_display_pointer_ungrab (display, GDK_CURRENT_TIME);
 493
 494   g_signal_handlers_disconnect_by_func (G_OBJECT (accel->grab_widget),
 495                                         G_CALLBACK (grab_key_callback),
 496                                         accel);
 497 }
 498
 499 static void
 500 _gtk_cell_editable_event_box_start_editing (GtkCellEditable *cell_editable,
 501                                             GdkEvent        *event)
 502 {
 503   /* do nothing, because we are pointless */
 504 }
 505
 506 static void
 507 _gtk_cell_editable_event_box_cell_editable_init (GtkCellEditableIface *iface)
 508 {
 509   iface->start_editing = _gtk_cell_editable_event_box_start_editing;
 510 }
 511
 512 typedef GtkEventBox      GtkCellEditableEventBox;
 513 typedef GtkEventBoxClass GtkCellEditableEventBoxClass;
 514
 515 G_DEFINE_TYPE_WITH_CODE (GtkCellEditableEventBox, _gtk_cell_editable_event_box, GTK_TYPE_EVENT_BOX, { \
 516     G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_EDITABLE, _gtk_cell_editable_event_box_cell_editable_init)   \
 517       })
 518
 519
 520 static void
 521 _gtk_cell_editable_event_box_class_init (GtkCellEditableEventBoxClass *class)
 522 {
 523 }
 524
 525 static void
 526 _gtk_cell_editable_event_box_init (GtkCellEditableEventBox *box)
 527 {
 528 }
 529
 530 static GtkCellEditable *
 531 gtk_cell_renderer_accel_start_editing (GtkCellRenderer      *cell,
 532                                        GdkEvent             *event,
 533                                        GtkWidget            *widget,
 534                                        const gchar          *path,
 535                                        GdkRectangle         *background_area,
 536                                        GdkRectangle         *cell_area,
 537                                        GtkCellRendererState  flags)
 538 {
 539   GtkCellRendererText *celltext;
 540   GtkCellRendererAccel *accel;
 541   GtkWidget *label;
 542   GtkWidget *eventbox;
 543
 544   celltext = GTK_CELL_RENDERER_TEXT (cell);
 545   accel = GTK_CELL_RENDERER_ACCEL (cell);
 546
 547   /* If the cell isn't editable we return NULL. */
 548   if (celltext->editable == FALSE)
 549     return NULL;
 550
 551   g_return_val_if_fail (widget->window != NULL, NULL);
 552
 553   if (gdk_keyboard_grab (widget->window, FALSE,
 554                          gdk_event_get_time (event)) != GDK_GRAB_SUCCESS)
 555     return NULL;
 556
 557   if (gdk_pointer_grab (widget->window, FALSE,
 558                         GDK_BUTTON_PRESS_MASK,
 559                         NULL, NULL,
 560                         gdk_event_get_time (event)) != GDK_GRAB_SUCCESS)
 561     {
 562       gdk_display_keyboard_ungrab (gtk_widget_get_display (widget),
 563                                    gdk_event_get_time (event));
 564       return NULL;
 565     }
 566
 567   accel->grab_widget = widget;
 568
 569   g_signal_connect (G_OBJECT (widget), "key-press-event",
 570                     G_CALLBACK (grab_key_callback),
 571                     accel);
 572
 573   eventbox = g_object_new (_gtk_cell_editable_event_box_get_type (), NULL);
 574   accel->edit_widget = eventbox;
 575   g_object_add_weak_pointer (G_OBJECT (accel->edit_widget),
 576                              (gpointer) &accel->edit_widget);
 577
 578   label = gtk_label_new (NULL);
 579   gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.5);
 580
 581   gtk_widget_modify_bg (eventbox, GTK_STATE_NORMAL,
 582                         &widget->style->bg[GTK_STATE_SELECTED]);
 583
 584   gtk_widget_modify_fg (label, GTK_STATE_NORMAL,
 585                         &widget->style->fg[GTK_STATE_SELECTED]);
 586
 587   /* This label is displayed in a treeview cell displaying
 588    * an accelerator when the cell is clicked to change the
 589    * acelerator.
 590    */
 591   gtk_label_set_text (GTK_LABEL (label), _("New accelerator..."));
 592
 593   gtk_container_add (GTK_CONTAINER (eventbox), label);
 594
 595   g_object_set_data_full (G_OBJECT (accel->edit_widget), "gtk-cell-renderer-text",
 596                           g_strdup (path), g_free);
 597
 598   gtk_widget_show_all (accel->edit_widget);
 599
 600   g_signal_connect (G_OBJECT (accel->edit_widget), "unrealize",
 601                     G_CALLBACK (ungrab_stuff), accel);
 602
 603   return GTK_CELL_EDITABLE (accel->edit_widget);
 604 }
 605
 606
 607 #define __GTK_CELL_RENDERER_ACCEL_C__
 608 #include "gtkaliasdef.c"