GtkEventControllerKey
GtkEventControllerKey — Контроллер событий для событий нажатия клавиш
Функции
Сигналы
| void | im-update | Выполняется последним |
| gboolean | key-pressed | Выполняется последним |
| void | key-released | Выполняется последним |
| gboolean | modifiers | Выполняется последним |
Типы и значения
Иерархия объектов
GObject
╰── GtkEventController
╰── GtkEventControllerKey
Файлы
#include <gtk/gtk.h>
Описание
GtkEventControllerKey — контроллер событий, предназначенный для случаев, когда нужен доступ к событиям нажатия клавиш.
Функции
gtk_event_controller_key_new ()
GtkEventController *
gtk_event_controller_key_new (void); Создаёт новый контроллер событий, который будет обрабатывать события нажатия клавиш.
Возвращает
новый GtkEventControllerKey
gtk_event_controller_key_set_im_context ()
void gtk_event_controller_key_set_im_context (GtkEventControllerKey *controller,GtkIMContext *im_context);
Устанавливает контекст метода ввода для клавиши controller.
Параметры
controller | объект GtkEventControllerKey | |
im_context | объект GtkIMContext |
gtk_event_controller_key_get_im_context ()
GtkIMContext *
gtk_event_controller_key_get_im_context
(GtkEventControllerKey *controller); Получает контекст метода ввода для клавиши controller.
Параметры
controller | объект GtkEventControllerKey |
gtk_event_controller_key_forward ()
gboolean gtk_event_controller_key_forward (GtkEventControllerKey *controller,GtkWidget *widget);
Передаёт текущее событие этого controller в widget.
Эту функцию можно использовать только в обработчиках сигналов “key-pressed”, “key-released” или “modifiers”.
Параметры
controller | объект GtkEventControllerKey | |
widget | объект GtkWidget |
Возвращает
обрабатывал ли widget событие
gtk_event_controller_key_get_group ()
guint
gtk_event_controller_key_get_group (GtkEventControllerKey *controller); Получает группу клавиш текущего события этого controller. См. gdk_key_event_get_group().
Параметры
controller | объект GtkEventControllerKey |
Возвращает
группу клавиш
Типы и значения
GtkEventControllerKey
typedef struct _GtkEventControllerKey GtkEventControllerKey;
Подробности сигналов
Сигнал “im-update”
void user_function (GtkEventControllerKey *controller, gpointer user_data)
Этот сигнал генерируется всякий раз, когда контекст ввода обрабатывает нажатие клавиши, отфильтровывает его и не позволяет controller его получить. См. gtk_event_controller_key_set_im_context() и gtk_im_context_filter_keypress().
Параметры
controller | объект, получивший сигнал | |
user_data | данные пользователя, заданные при подключении обработчика сигналов. |
Флаги: Run Last
Сигнал “key-pressed”
gboolean user_function (GtkEventControllerKey *controller, guint keyval, guint keycode, GdkModifierType state, gpointer user_data)
Этот сигнал генерируется всякий раз, когда нажимается клавиша.
Параметры
controller | объект, получивший сигнал. | |
keyval | нажатая клавиша. | |
keycode | сырой код нажатой клавиши. | |
state | маска битов, представляющая состояние клавиш-модификаторов и кнопок указателя. См. GdkModifierType. | |
user_data | данные пользователя, заданные при подключении обработчика сигналов. |
Возвращаемое значение
TRUE если нажатие клавиши было обработано, FALSE в противном случае.
Флаги: Run Last
Сигнал “key-released”
void user_function (GtkEventControllerKey *controller, guint keyval, guint keycode, GdkModifierType state, gpointer user_data)
Этот сигнал генерируется всякий раз, когда клавиша отпускается.
Параметры
controller | объект, получивший сигнал. | |
keyval | отпущенная клавиша. | |
keycode | сырой код отпущенной клавиши. | |
state | маска битов, представляющая состояние клавиш-модификаторов и кнопок указателя. См. GdkModifierType. | |
user_data | данные пользователя, заданные при подключении обработчика сигналов. |
Флаги: Run Last
Сигнал “modifiers”
gboolean user_function (GtkEventControllerKey *controller, GdkModifierType keyval, gpointer user_data)
Этот сигнал генерируется всякий раз, когда изменяется состояние клавиш-модификаторов и кнопок указателя.
Параметры
controller | объект, получивший сигнал. | |
keyval | отпущенная клавиша. | |
state | маска битов, представляющая новое состояние клавиш-модификаторов и кнопок указателя. См. GdkModifierType. | |
user_data | данные пользователя, заданные при подключении обработчика сигналов. |
Флаги: Run Last
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkEventControllerKey.html
