GtkGestureSingle
GtkGestureSingle — Базовый класс для жестов мыши/одного касания
Функции
Свойства
| guint | кнопка | Чтение/Запись |
| gboolean | исключительный | Чтение/Запись |
| gboolean | только_касание | Чтение/Запись |
Типы и значения
Иерархия объектов
GObject ╰── GtkEventController ╰── GtkGesture ╰── GtkGestureSingle ├── GtkGestureDrag ├── GtkGestureLongPress ├── GtkGestureMultiPress ╰── GtkGestureSwipe
Файлы заголовков
#include <gtk/gtk.h>
Описание
GtkGestureSingle — подкласс GtkGesture, оптимизированный (хотя и не ограниченный) для работы с жестами мыши и одного касания. Во время взаимодействия эти жесты привязываются к первому взаимодействующему событию, которое доступно через gtk_gesture_single_get_current_sequence() во время взаимодействия с жестом.
По умолчанию жесты реагируют на события GDK_BUTTON_PRIMARY и касания, gtk_gesture_single_set_touch_only() может использоваться для изменения поведения касания. Вызывающие стороны могут также указать другой номер кнопки мыши для взаимодействия с помощью gtk_gesture_single_set_button(), или реагировать на любую кнопку мыши, установив значение 0. Во время активности жеста номер нажатой кнопки можно узнать с помощью gtk_gesture_single_get_current_button().
Функции
gtk_gesture_single_get_exclusive ()
gboolean
gtk_gesture_single_get_exclusive (GtkGestureSingle *gesture); Определяет, является ли жест эксклюзивным. Дополнительную информацию см. в gtk_gesture_single_set_exclusive().
Параметры
жест |
Возвращаемое значение
Является ли жест эксклюзивным
С: 3.14
gtk_gesture_single_set_exclusive ()
void gtk_gesture_single_set_exclusive (GtkGestureSingle *gesture,gboolean exclusive);
Устанавливает, является ли gesture эксклюзивным. Эксклюзивный жест обрабатывает только события указателя и «эмулированные указателем» сенсорные события, поэтому в любой момент времени только одна последовательность может взаимодействовать с ними.
Параметры
жест | ||
эксклюзивный |
|
С: 3.14
gtk_gesture_single_get_touch_only ()
gboolean
gtk_gesture_single_get_touch_only (GtkGestureSingle *gesture); Возвращает TRUE, если жест срабатывает только при сенсорных событиях.
Параметры
жест |
Возвращаемое значение
TRUE, если жест обрабатывает только сенсорные события
С: 3.14
gtk_gesture_single_set_touch_only ()
void gtk_gesture_single_set_touch_only (GtkGestureSingle *gesture,gboolean touch_only);
Если touch_only равно TRUE, gesture будет обрабатывать только события типа GDK_TOUCH_BEGIN, GDK_TOUCH_UPDATE или GDK_TOUCH_END. Если FALSE, будут обрабатываться и события мыши.
Параметры
жест | ||
только_сенсорные_события | обрабатываются ли только сенсорные события |
С: 3.14
gtk_gesture_single_get_button ()
guint
gtk_gesture_single_get_button (GtkGestureSingle *gesture); Возвращает номер кнопки, за которой следит gesture, или 0, если gesture реагирует на нажатие любой кнопки.
Параметры
жест |
Возвращаемое значение
Номер кнопки или 0 для любой кнопки
С: 3.14
gtk_gesture_single_set_button ()
void gtk_gesture_single_set_button (GtkGestureSingle *gesture,guint button);
Устанавливает номер кнопки, за которой следит gesture. Если он отличен от 0, все нажатия кнопок с другим номером будут игнорироваться. Сенсорные события неявно соответствуют кнопке 1.
Параметры
жест | ||
кнопка | номер кнопки, за которой следить, или 0 для любой кнопки |
С: 3.14
gtk_gesture_single_get_current_button ()
guint
gtk_gesture_single_get_current_button (GtkGestureSingle *gesture); Возвращает номер кнопки, в настоящий момент взаимодействующей с gesture, или 0, если таковой нет.
Параметры
жест |
Возвращаемое значение
Текущий номер кнопки
С: 3.14
gtk_gesture_single_get_current_sequence ()
GdkEventSequence *
gtk_gesture_single_get_current_sequence
(GtkGestureSingle *gesture); Возвращает последовательность событий, в настоящий момент взаимодействующую с gesture. Это имеет смысл только если gtk_gesture_is_active() возвращает TRUE.
Параметры
жест |
Возвращаемое значение
текущую последовательность.
[nullable]
С: 3.14
Типы и значения
GtkGestureSingle
typedef struct _GtkGestureSingle GtkGestureSingle;
Подробное описание свойств
Свойство “button”
“button” guint
Номер кнопки мыши, за которой следить, или 0, чтобы следить за любой кнопкой.
Флаги: Чтение / Запись
Значение по умолчанию: 1
С: 3.14
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.20/GtkGestureSingle.html
