gtk_event_controller_key_new ()

GtkEventController *
gtk_event_controller_key_new (void);

Creates a new event controller that will handle key events.

gtk_event_controller_key_set_im_context ()

void
gtk_event_controller_key_set_im_context
                               (GtkEventControllerKey *controller,
                                GtkIMContext *im_context);

Sets the input method context of the key controller .

gtk_event_controller_key_get_im_context ()

GtkIMContext *
gtk_event_controller_key_get_im_context
                               (GtkEventControllerKey *controller);

Gets the input method context of the key controller .

gtk_event_controller_key_forward ()

gboolean
gtk_event_controller_key_forward (GtkEventControllerKey *controller,
                                  GtkWidget *widget);

Forwards the current event of this controller to a widget .

This function can only be used in handlers for the “key-pressed”, “key-released” or “modifiers” signals.

gtk_event_controller_key_get_group ()

guint
gtk_event_controller_key_get_group (GtkEventControllerKey *controller);

Gets the key group of the current event of this controller . See gdk_event_get_key_group().

gtk_event_controller_key_get_focus_origin ()

GtkWidget *
gtk_event_controller_key_get_focus_origin
                               (GtkEventControllerKey *controller);

Returns the widget that was holding focus before.

This function can only be used in handlers for the “focus-in” and “focus-out” signals.

gtk_event_controller_key_get_focus_target ()

GtkWidget *
gtk_event_controller_key_get_focus_target
                               (GtkEventControllerKey *controller);

Returns the widget that will be holding focus afterwards.

This function can only be used in handlers for the “focus-in” and “focus-out” signals.

GtkEventControllerKey

typedef struct _GtkEventControllerKey GtkEventControllerKey;

The “contains-focus” property

  “contains-focus”           gboolean

Whether focus is in a descendant of the controllers widget. See “is-focus”.

When handling focus events, this property is updated before “focus-in” or “focus-out” are emitted.

Flags: Read

Default value: FALSE

The “is-focus” property

  “is-focus”                 gboolean

Whether focus is in the controllers widget itself, as opposed to in a descendent widget. See “contains-focus”.

When handling focus events, this property is updated before “focus-in” or “focus-out” are emitted.

Flags: Read

Default value: FALSE

The “focus-in” signal

void
user_function (GtkEventControllerKey *controller,
               GdkCrossingMode        mode,
               GdkNotifyType          detail,
               gpointer               user_data)

This signal is emitted whenever the widget controlled by the controller or one of its descendants) is given the keyboard focus.

Flags: Run Last

The “focus-out” signal

void
user_function (GtkEventControllerKey *controller,
               GdkCrossingMode        mode,
               GdkNotifyType          detail,
               gpointer               user_data)

This signal is emitted whenever the widget controlled by the controller (or one of its descendants) loses the keyboard focus.

Flags: Run Last

The “im-update” signal

void
user_function (GtkEventControllerKey *controller,
               gpointer               user_data)

This signal is emitted whenever the input method context filters away a keypress and prevents the controller receiving it. See gtk_event_controller_key_set_im_context() and gtk_im_context_filter_keypress().

Flags: Run Last

The “key-pressed” signal

gboolean
user_function (GtkEventControllerKey *controller,
               guint                  keyval,
               guint                  keycode,
               GdkModifierType        state,
               gpointer               user_data)

This signal is emitted whenever a key is pressed.

Flags: Run Last

The “key-released” signal

void
user_function (GtkEventControllerKey *controller,
               guint                  keyval,
               guint                  keycode,
               GdkModifierType        state,
               gpointer               user_data)

This signal is emitted whenever a key is released.

Flags: Run Last

The “modifiers” signal

gboolean
user_function (GtkEventControllerKey *controller,
               GdkModifierType        keyval,
               gpointer               user_data)

This signal is emitted whenever the state of modifier keys and pointer buttons change.

Flags: Run Last