W3cubDocs

/GTK 3.24

GtkEventControllerKey

GtkEventControllerKey — Event controller for key events

Signals

void focus-in Run Last
void focus-out Run Last
void im-update Run Last
gboolean key-pressed Run Last
void key-released Run Last
gboolean modifiers Run Last

Types and Values

Object Hierarchy

    GObject
    ╰── GtkEventController
        ╰── GtkEventControllerKey

Includes

#include <gtk/gtk.h>

Description

GtkEventControllerKey is an event controller meant for situations where you need access to key events.

This object was added in 3.24.

Functions

gtk_event_controller_key_new ()

GtkEventController *
gtk_event_controller_key_new (GtkWidget *widget);

Types and Values

GtkEventControllerKey

typedef struct _GtkEventControllerKey GtkEventControllerKey;

Signal Details

The “focus-in” signal

void
user_function (GtkEventControllerKey *eventcontrollerkey,
               gpointer               user_data)

Flags: Run Last

The “focus-out” signal

void
user_function (GtkEventControllerKey *eventcontrollerkey,
               gpointer               user_data)

Flags: Run Last

The “im-update” signal

void
user_function (GtkEventControllerKey *eventcontrollerkey,
               gpointer               user_data)

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.

Parameters

controller

the object which received the signal.

keyval

the pressed key.

keycode

the raw code of the pressed key.

state

the bitmask, representing the state of modifier keys and pointer buttons. See GdkModifierType.

user_data

user data set when the signal handler was connected.

Returns

TRUE if the key press was handled, FALSE otherwise.

Flags: Run Last

Since: 3.24

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.

Parameters

controller

the object which received the signal.

keyval

the released key.

keycode

the raw code of the released key.

state

the bitmask, representing the state of modifier keys and pointer buttons. See GdkModifierType.

user_data

user data set when the signal handler was connected.

Flags: Run Last

Since: 3.24

The “modifiers” signal

gboolean
user_function (GtkEventControllerKey *eventcontrollerkey,
               GdkModifierType        arg1,
               gpointer               user_data)

Flags: Run Last

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkEventControllerKey.html