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 | кнопка | Чтение/Запись |
| gboolean | исключительный | Чтение/Запись |
| gboolean | только касание | Чтение/Запись |
Типы и значения
Иерархия объектов
GObject
╰── GtkEventController
╰── GtkGesture
╰── GtkGestureSingle
├── GtkGestureDrag
├── GtkGestureLongPress
├── GtkGestureMultiPress
├── 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().
Параметры
жест |
Возвращаемое значение
Является ли жест эксклюзивным
С: 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, будут обрабатываться и события мыши.
Параметры
жест | ||
touch_only | является ли |
С: 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 для любой кнопки.
Владелец: GtkGestureSingle
Флаги: Чтение / Запись
Значение по умолчанию: 1
С: 3.14
Свойство “exclusive”
“exclusive” gboolean
Является ли жест эксклюзивным. Эксклюзивные жесты реагируют только на события указателя и событий касания, эмулированные с помощью указателя.
Владелец: GtkGestureSingle
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С: 3.14
Свойство “touch-only”
“touch-only” gboolean
Обрабатывает ли жест только события касания.
Владелец: GtkGestureSingle
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С: 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.24/GtkGestureSingle.html
