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_name (keysym, mask);
 253           if (keysym == 0)
 254             {
 255               gchar *tmp;
 256
 257               tmp = name;
 258               name = g_strdup_printf ("%s0x%02x", tmp, keycode);
 259               g_free (tmp);
 260             }
 261
 262           return name;
 263         }
 264     }
 265 }
 266
 267 static void
 268 gtk_cell_renderer_accel_get_property  (GObject    *object,
 269                                        guint       param_id,
 270                                        GValue     *value,
 271                                        GParamSpec *pspec)
 272 {
 273   GtkCellRendererAccel *accel = GTK_CELL_RENDERER_ACCEL (object);
 274
 275   switch (param_id)
 276     {
 277     case PROP_ACCEL_KEY:
 278       g_value_set_uint (value, accel->accel_key);
 279       break;
 280
 281     case PROP_ACCEL_MODS:
 282       g_value_set_flags (value, accel->accel_mods);
 283       break;
 284
 285     case PROP_KEYCODE:
 286       g_value_set_uint (value, accel->keycode);
 287       break;
 288
 289     case PROP_ACCEL_MODE:
 290       g_value_set_enum (value, accel->accel_mode);
 291       break;
 292
 293     default:
 294       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
 295     }
 296 }
 297
 298 static void
 299 gtk_cell_renderer_accel_set_property  (GObject      *object,
 300                                        guint         param_id,
 301                                        const GValue *value,
 302                                        GParamSpec   *pspec)
 303 {
 304   GtkCellRendererAccel *accel = GTK_CELL_RENDERER_ACCEL (object);
 305   gboolean changed = FALSE;
 306
 307   switch (param_id)
 308     {
 309     case PROP_ACCEL_KEY:
 310       {
 311         guint accel_key = g_value_get_uint (value);
 312
 313         if (accel->accel_key != accel_key)
 314           {
 315             accel->accel_key = accel_key;
 316             changed = TRUE;
 317           }
 318       }
 319       break;
 320
 321     case PROP_ACCEL_MODS:
 322       {
 323         guint accel_mods = g_value_get_flags (value);
 324
 325         if (accel->accel_mods != accel_mods)
 326           {
 327             accel->accel_mods = accel_mods;
 328             changed = TRUE;
 329           }
 330       }
 331       break;
 332     case PROP_KEYCODE:
 333       {
 334         guint keycode = g_value_get_uint (value);
 335
 336         if (accel->keycode != keycode)
 337           {
 338             accel->keycode = keycode;
 339             changed = TRUE;
 340           }
 341       }
 342       break;
 343
 344     case PROP_ACCEL_MODE:
 345       accel->accel_mode = g_value_get_enum (value);
 346       break;
 347
 348     default:
 349       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
 350     }
 351
 352   if (changed)
 353     {
 354       gchar *text;
 355
 356       text = convert_keysym_state_to_string (accel, accel->accel_key, accel->accel_mods, accel->keycode);
 357       g_object_set (accel, "text", text, NULL);
 358       g_free (text);
 359     }
 360 }
 361
 362 static void
 363 gtk_cell_renderer_accel_get_size (GtkCellRenderer *cell,
 364                                   GtkWidget       *widget,
 365                                   GdkRectangle    *cell_area,
 366                                   gint            *x_offset,
 367                                   gint            *y_offset,
 368                                   gint            *width,
 369                                   gint            *height)
 370
 371 {
 372   GtkCellRendererAccel *accel = (GtkCellRendererAccel *) cell;
 373   GtkRequisition requisition;
 374
 375   if (accel->sizing_label == NULL)
 376     accel->sizing_label = gtk_label_new (_("New accelerator..."));
 377
 378   gtk_widget_size_request (accel->sizing_label, &requisition);
 379
 380   GTK_CELL_RENDERER_CLASS (gtk_cell_renderer_accel_parent_class)->get_size (cell, widget, cell_area,
 381                                                                             x_offset, y_offset, width, height);
 382
 383   /* FIXME: need to take the cell_area et al. into account */
 384   if (width)
 385     *width = MAX (*width, requisition.width);
 386   if (height)
 387     *height = MAX (*height, requisition.height);
 388 }
 389
 390 static gboolean
 391 grab_key_callback (GtkWidget            *widget,
 392                    GdkEventKey          *event,
 393                    GtkCellRendererAccel *accel)
 394 {
 395   GdkModifierType accel_mods = 0;
 396   guint accel_key;
 397   gchar *path;
 398   gboolean edited;
 399   gboolean cleared;
 400   GdkModifierType consumed_modifiers;
 401   GdkDisplay *display;
 402
 403   display = gtk_widget_get_display (widget);
 404
 405   if (event->is_modifier)
 406     return TRUE;
 407
 408   edited = FALSE;
 409   cleared = FALSE;
 410
 411   gdk_keymap_translate_keyboard_state (gdk_keymap_get_for_display (display),
 412                                        event->hardware_keycode,
 413                                        event->state,
 414                                        event->group,
 415                                        NULL, NULL, NULL, &consumed_modifiers);
 416
 417   accel_key = gdk_keyval_to_lower (event->keyval);
 418   if (accel_key == GDK_ISO_Left_Tab)
 419     accel_key = GDK_Tab;
 420
 421   accel_mods = event->state & gtk_accelerator_get_default_mod_mask ();
 422
 423   /* Filter consumed modifiers
 424    */
 425   if (accel->accel_mode == GTK_CELL_RENDERER_ACCEL_MODE_GTK)
 426     accel_mods &= ~consumed_modifiers;
 427
 428   /* Put shift back if it changed the case of the key, not otherwise.
 429    */
 430   if (accel_key != event->keyval)
 431     accel_mods |= GDK_SHIFT_MASK;
 432
 433   if (accel_mods == 0)
 434     {
 435       switch (event->keyval)
 436         {
 437         case GDK_Escape:
 438           goto out; /* cancel */
 439         case GDK_BackSpace:
 440           /* clear the accelerator on Backspace */
 441           cleared = TRUE;
 442           goto out;
 443         default:
 444           break;
 445         }
 446     }
 447
 448   if (accel->accel_mode == GTK_CELL_RENDERER_ACCEL_MODE_GTK)
 449     {
 450       if (!gtk_accelerator_valid (accel_key, accel_mods))
 451         {
 452           gtk_widget_error_bell (widget);
 453
 454           return TRUE;
 455         }
 456     }
 457
 458   edited = TRUE;
 459
 460  out:
 461   gdk_display_keyboard_ungrab (display, event->time);
 462   gdk_display_pointer_ungrab (display, event->time);
 463
 464   path = g_strdup (g_object_get_data (G_OBJECT (accel->edit_widget), "gtk-cell-renderer-text"));
 465
 466   gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (accel->edit_widget));
 467   gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (accel->edit_widget));
 468   accel->edit_widget = NULL;
 469   accel->grab_widget = NULL;
 470
 471   if (edited)
 472     g_signal_emit (accel, signals[ACCEL_EDITED], 0, path,
 473                    accel_key, accel_mods, event->hardware_keycode);
 474   else if (cleared)
 475     g_signal_emit (accel, signals[ACCEL_CLEARED], 0, path);
 476
 477   g_free (path);
 478
 479   return TRUE;
 480 }
 481
 482 static void
 483 ungrab_stuff (GtkWidget            *widget,
 484               GtkCellRendererAccel *accel)
 485 {
 486   GdkDisplay *display = gtk_widget_get_display (widget);
 487
 488   gdk_display_keyboard_ungrab (display, GDK_CURRENT_TIME);
 489   gdk_display_pointer_ungrab (display, GDK_CURRENT_TIME);
 490
 491   g_signal_handlers_disconnect_by_func (G_OBJECT (accel->grab_widget),
 492                                         G_CALLBACK (grab_key_callback),
 493                                         accel);
 494 }
 495
 496 static void
 497 _gtk_cell_editable_event_box_start_editing (GtkCellEditable *cell_editable,
 498                                             GdkEvent        *event)
 499 {
 500   /* do nothing, because we are pointless */
 501 }
 502
 503 static void
 504 _gtk_cell_editable_event_box_cell_editable_init (GtkCellEditableIface *iface)
 505 {
 506   iface->start_editing = _gtk_cell_editable_event_box_start_editing;
 507 }
 508
 509 typedef GtkEventBox      GtkCellEditableEventBox;
 510 typedef GtkEventBoxClass GtkCellEditableEventBoxClass;
 511
 512 G_DEFINE_TYPE_WITH_CODE (GtkCellEditableEventBox, _gtk_cell_editable_event_box, GTK_TYPE_EVENT_BOX, { \
 513     G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_EDITABLE, _gtk_cell_editable_event_box_cell_editable_init)   \
 514       })
 515
 516
 517 static void
 518 _gtk_cell_editable_event_box_class_init (GtkCellEditableEventBoxClass *class)
 519 {
 520 }
 521
 522 static void
 523 _gtk_cell_editable_event_box_init (GtkCellEditableEventBox *box)
 524 {
 525 }
 526
 527 static GtkCellEditable *
 528 gtk_cell_renderer_accel_start_editing (GtkCellRenderer      *cell,
 529                                        GdkEvent             *event,
 530                                        GtkWidget            *widget,
 531                                        const gchar          *path,
 532                                        GdkRectangle         *background_area,
 533                                        GdkRectangle         *cell_area,
 534                                        GtkCellRendererState  flags)
 535 {
 536   GtkCellRendererText *celltext;
 537   GtkCellRendererAccel *accel;
 538   GtkWidget *label;
 539   GtkWidget *eventbox;
 540
 541   celltext = GTK_CELL_RENDERER_TEXT (cell);
 542   accel = GTK_CELL_RENDERER_ACCEL (cell);
 543
 544   /* If the cell isn't editable we return NULL. */
 545   if (celltext->editable == FALSE)
 546     return NULL;
 547
 548   g_return_val_if_fail (widget->window != NULL, NULL);
 549
 550   if (gdk_keyboard_grab (widget->window, FALSE,
 551                          gdk_event_get_time (event)) != GDK_GRAB_SUCCESS)
 552     return NULL;
 553
 554   if (gdk_pointer_grab (widget->window, FALSE,
 555                         GDK_BUTTON_PRESS_MASK,
 556                         NULL, NULL,
 557                         gdk_event_get_time (event)) != GDK_GRAB_SUCCESS)
 558     {
 559       gdk_display_keyboard_ungrab (gtk_widget_get_display (widget),
 560                                    gdk_event_get_time (event));
 561       return NULL;
 562     }
 563
 564   accel->grab_widget = widget;
 565
 566   g_signal_connect (G_OBJECT (widget), "key-press-event",
 567                     G_CALLBACK (grab_key_callback),
 568                     accel);
 569
 570   eventbox = g_object_new (_gtk_cell_editable_event_box_get_type (), NULL);
 571   accel->edit_widget = eventbox;
 572   g_object_add_weak_pointer (G_OBJECT (accel->edit_widget),
 573                              (gpointer) &accel->edit_widget);
 574
 575   label = gtk_label_new (NULL);
 576   gtk_misc_set_alignment (GTK_MISC (label), 0.0, 0.5);
 577
 578   gtk_widget_modify_bg (eventbox, GTK_STATE_NORMAL,
 579                         &widget->style->bg[GTK_STATE_SELECTED]);
 580
 581   gtk_widget_modify_fg (label, GTK_STATE_NORMAL,
 582                         &widget->style->fg[GTK_STATE_SELECTED]);
 583
 584   /* This label is displayed in a treeview cell displaying
 585    * an accelerator when the cell is clicked to change the
 586    * acelerator.
 587    */
 588   gtk_label_set_text (GTK_LABEL (label), _("New accelerator..."));
 589
 590   gtk_container_add (GTK_CONTAINER (eventbox), label);
 591
 592   g_object_set_data_full (G_OBJECT (accel->edit_widget), "gtk-cell-renderer-text",
 593                           g_strdup (path), g_free);
 594
 595   gtk_widget_show_all (accel->edit_widget);
 596
 597   g_signal_connect (G_OBJECT (accel->edit_widget), "unrealize",
 598                     G_CALLBACK (ungrab_stuff), accel);
 599
 600   return GTK_CELL_EDITABLE (accel->edit_widget);
 601 }
 602
 603
 604 #define __GTK_CELL_RENDERER_ACCEL_C__
 605 #include "gtkaliasdef.c"