GtkGestureSingle
GtkGestureSingle — Базовый класс для жестов мыши/одноточечного касания
Функции
| gboolean | gtk_gesture_single_get_exclusive () |
| void | gtk_gesture_single_set_exclusive () |
| gboolean | gtk_gesture_single_get_touch_only () |
| void | gtk_gesture_single_set_touch_only () |
| guint | gtk_gesture_single_get_button () |
| void | gtk_gesture_single_set_button () |
| guint | gtk_gesture_single_get_current_button () |
| GdkEventSequence * | gtk_gesture_single_get_current_sequence () |
Свойства
| guint | button | Чтение / Запись |
| gboolean | exclusive | Чтение / Запись |
| gboolean | touch-only | Чтение / Запись |
Типы и значения
Иерархия объектов
GObject
╰── GtkEventController
╰── GtkGesture
╰── GtkGestureSingle
├── GtkDragSource
├── GtkGestureClick
├── GtkGestureDrag
├── GtkGestureLongPress
├── GtkGestureStylus
╰── 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().
Параметры
gesture |
Возвращаемое значение
Является ли жестикуляция эксклюзивной
gtk_gesture_single_set_exclusive ()
void gtk_gesture_single_set_exclusive (GtkGestureSingle *gesture,gboolean exclusive);
Устанавливает, является ли gesture эксклюзивной. Эксклюзивная жестикуляция будет обрабатывать только события указателя и "эмулируемых указателем" касаний, поэтому в любой момент времени только одна последовательность может взаимодействовать с ними.
Параметры
gesture | ||
exclusive |
|
gtk_gesture_single_get_touch_only ()
gboolean
gtk_gesture_single_get_touch_only (GtkGestureSingle *gesture); Возвращает TRUE, если жестикуляция срабатывает только от событий касания.
Параметры
gesture |
Возвращаемое значение
TRUE если жестикуляция обрабатывает только события касания
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, то будут обрабатываться и события мыши.
Параметры
gesture | ||
touch_only | является ли |
gtk_gesture_single_get_button ()
guint
gtk_gesture_single_get_button (GtkGestureSingle *gesture); Возвращает номер кнопки, за которой следит gesture, или 0, если gesture реагирует на любой нажатие.
Параметры
gesture |
Возвращаемое значение
Номер кнопки, или 0 для любой кнопки
gtk_gesture_single_set_button ()
void gtk_gesture_single_set_button (GtkGestureSingle *gesture,guint button);
Устанавливает номер кнопки, за которой следит gesture. Если ненулевой, каждое нажатие другой кнопкой будет проигнорировано. События касания подразумевают соответствие кнопке 1.
Параметры
gesture | ||
button | номер кнопки, за которой следить, или 0 для любой кнопки |
gtk_gesture_single_get_current_button ()
guint
gtk_gesture_single_get_current_button (GtkGestureSingle *gesture); Возвращает номер кнопки, в настоящее время взаимодействующей с gesture, или 0, если таковой нет.
Параметры
gesture |
Возвращаемое значение
Текущий номер кнопки
gtk_gesture_single_get_current_sequence ()
GdkEventSequence *
gtk_gesture_single_get_current_sequence
(GtkGestureSingle *gesture); Возвращает последовательность событий, в настоящее время взаимодействующих с gesture. Это имеет смысл только если gtk_gesture_is_active() возвращает TRUE.
Параметры
gesture |
Возвращаемое значение
текущая последовательность.
[nullable]
Типы и значения
GtkGestureSingle
typedef struct _GtkGestureSingle GtkGestureSingle;
Подробное описание свойств
Свойство “button”
“button” guint
Номер кнопки мыши, за которой следить, или 0, чтобы следить за любой кнопкой.
Владелец: GtkGestureSingle
Флаги: Чтение / Запись
Значение по умолчанию: 1
Свойство “exclusive”
“exclusive” gboolean
Является ли жестикуляция эксклюзивной. Эксклюзивные жестикуляции реагируют только на события указателя и эмулируемого указателя.
Владелец: GtkGestureSingle
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “touch-only”
“touch-only” gboolean
Обрабатывает ли жестикуляция только события касания.
Владелец: GtkGestureSingle
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
© 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/GtkGestureSingle.html
