GtkCellRendererAccel

GtkCellRendererAccel — Renders a keyboard accelerator in a cell

Synopsis


#include <gtk/gtk.h>


            GtkCellRendererAccel;
enum        GtkCellRendererAccelMode;
GtkCellRenderer* gtk_cell_renderer_accel_new
                                            (void);

Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkCellRenderer
                     +----GtkCellRendererText
                           +----GtkCellRendererAccel

Properties


  "accel-key"            guint                 : Read / Write
  "accel-mode"           GtkCellRendererAccelMode  : Read / Write
  "accel-mods"           GdkModifierType       : Read / Write
  "keycode"              guint                 : Read / Write

Signals


"accel-cleared"
            void        user_function      (GtkCellRendererAccel *accel,
                                            gchar                *path_string,
                                            gpointer              user_data)        : Run last
"accel-edited"
            void        user_function      (GtkCellRendererAccel *accel,
                                            gchar                *path_string,
                                            guint                 accel_key,
                                            GdkModifierType      *accel_mods,
                                            guint                 hardware_keycode,
                                            gpointer              user_data)             : Run last

Description

GtkCellRendererAccel displays a keyboard accelerator (i.e. a key combination like <Control>-a). If the cell renderer is editable, the accelerator can be changed by simply typing the new combination.

The GtkCellRendererAccel cell renderer was added in GTK+ 2.10.

Details

GtkCellRendererAccel

typedef struct _GtkCellRendererAccel GtkCellRendererAccel;

enum GtkCellRendererAccelMode

typedef enum
{
  GTK_CELL_RENDERER_ACCEL_MODE_GTK,
  GTK_CELL_RENDERER_ACCEL_MODE_OTHER
} GtkCellRendererAccelMode;

gtk_cell_renderer_accel_new ()

GtkCellRenderer* gtk_cell_renderer_accel_new
                                            (void);

Creates a new GtkCellRendererAccel.

Returns : the new cell renderer

Since 2.10

Property Details

The "accel-key" property

  "accel-key"            guint                 : Read / Write

The keyval of the accelerator.

Allowed values: <= G_MAXINT

Default value: 0

Since 2.10

The "accel-mode" property

  "accel-mode"           GtkCellRendererAccelMode  : Read / Write

Determines if the edited accelerators are GTK+ accelerators. If they are, consumed modifiers are suppressed, only accelerators accepted by GTK+ are allowed, and the accelerators are rendered in the same way as they are in menus.

Default value: GTK_CELL_RENDERER_ACCEL_MODE_GTK

Since 2.10

The "accel-mods" property

  "accel-mods"           GdkModifierType       : Read / Write

The modifier mask of the accelerator.

Since 2.10

The "keycode" property

  "keycode"              guint                 : Read / Write

The hardware keycode of the accelerator. Note that the hardware keycode is only relevant if the key does not have a keyval. Normally, the keyboard configuration should assign keyvals to all keys.

Allowed values: <= G_MAXINT

Default value: 0

Since 2.10

Signal Details

The "accel-cleared" signal

void        user_function                  (GtkCellRendererAccel *accel,
                                            gchar                *path_string,
                                            gpointer              user_data)        : Run last

Gets emitted when the user has removed the accelerator.

accel : the object reveiving the signal
path_string : the path identifying the row of the edited cell
user_data : user data set when the signal handler was connected.

Since 2.10

The "accel-edited" signal

void        user_function                  (GtkCellRendererAccel *accel,
                                            gchar                *path_string,
                                            guint                 accel_key,
                                            GdkModifierType      *accel_mods,
                                            guint                 hardware_keycode,
                                            gpointer              user_data)             : Run last

Gets emitted when the user has selected a new accelerator.

accel : the object reveiving the signal
path_string : the path identifying the row of the edited cell
accel_key : the new accelerator keyval
accel_mods : the new acclerator modifier mask
hardware_keycode : the keycode of the new accelerator
user_data : user data set when the signal handler was connected.

Since 2.10