GtkGestureClick
GtkGestureClick — Жест многократного нажатия
Функции
Сигналы
| void | pressed | Run Last |
| void | released | Run Last |
| void | stopped | Run Last |
| void | unpaired-release | Run Last |
Типы и значения
Иерархия объектов
GObject
╰── GtkEventController
╰── GtkGesture
╰── GtkGestureSingle
╰── GtkGestureClick
Файлы заголовков
#include <gtk/gtk.h>
Описание
GtkGestureClick — это реализация GtkGesture, способная распознавать несколько нажатий в близкой зоне, которые можно прослушивать через сигнал “pressed”. Всякий раз, когда интервал времени или расстояние между нажатиями превышают значения по умолчанию GTK, генерируется сигнал “stopped”, и счетчик нажатий сбрасывается.
Функции
gtk_gesture_click_new ()
GtkGesture *
gtk_gesture_click_new (void); Возвращает новый созданный GtkGesture, который распознает одиночные и многократные нажатия.
Возвращает
новый созданный GtkGestureClick
Типы и значения
GtkGestureClick
typedef struct _GtkGestureClick GtkGestureClick;
Подробности сигналов
Сигнал “pressed”
void user_function (GtkGestureClick *gesture, int n_press, double x, double y, gpointer user_data)
Этот сигнал генерируется всякий раз, когда происходит нажатие кнопки или сенсорного касания.
Параметры
gesture | объект, получивший сигнал | |
n_press | количество нажатий, произошедших в рамках этого события | |
x | Координата X в координатах размещения виджета | |
y | Координата Y в координатах размещения виджета | |
user_data | данные пользователя, установленные при подключении обработчика сигнала. |
Флаги: Run Last
Сигнал “released”
void user_function (GtkGestureClick *gesture, int n_press, double x, double y, gpointer user_data)
Этот сигнал генерируется при отпускании кнопки или сенсорного касания. n_press указывает количество связанных с этим событием нажатий. Обратите внимание, что сигнал “stopped” может быть сгенерирован между нажатием и его отпусканием. n_press будет сброшен только при следующем нажатии.
Параметры
gesture | объект, получивший сигнал | |
n_press | количество нажатий, связанных с этим отпусканием | |
x | Координата X в координатах размещения виджета | |
y | Координата Y в координатах размещения виджета | |
user_data | данные пользователя, установленные при подключении обработчика сигнала. |
Флаги: Run Last
Сигнал “stopped”
void user_function (GtkGestureClick *gesture, gpointer user_data)
Этот сигнал генерируется всякий раз, когда превышен какой-либо порог времени/расстояния.
Параметры
gesture | объект, получивший сигнал | |
user_data | данные пользователя, установленные при подключении обработчика сигнала. |
Флаги: Run Last
Сигнал “unpaired-release”
void user_function (GtkGestureClick *gesture, double x, double y, guint button, GdkEventSequence *sequence, gpointer user_data)
Этот сигнал генерируется всякий раз, когда жест получает событие отпускания, не имеющее соответствующего предыдущего нажатия. Из-за неявных захватов это может произойти только в ситуациях, когда ввод захватывается где-то еще во время нажатия или виджет, получивший нажатие, добровольно отпускает свой неявный захват.
Параметры
gesture | объект, получивший сигнал | |
x | Координата X события | |
y | Координата Y события | |
button | Кнопка, которая отпускается | |
sequence | Последовательность, которая отпускается | |
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/GtkGestureClick.html