Spec-Zone.ru › GTK 3.22

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 только касание Чтение/Запись

Типы и значения

GtkGestureSingle

Иерархия объектов

    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().

Параметры

жест

a GtkGestureSingle

Возвращает

Является ли жест эксклюзивным

С: 3.14

gtk_gesture_single_set_exclusive ()

void
gtk_gesture_single_set_exclusive (GtkGestureSingle *gesture,
                                  gboolean exclusive);

Устанавливает, является ли gesture эксклюзивным. Эксклюзивный жест будет обрабатывать только события указателя и «эмулируемые указателем» сенсорные события, поэтому в любой момент времени только одна последовательность может взаимодействовать с ними.

Параметры

жест

a GtkGestureSingle

эксклюзивный

TRUE для того, чтобы сделать gesture эксклюзивным

С: 3.14

gtk_gesture_single_get_touch_only ()

gboolean
gtk_gesture_single_get_touch_only (GtkGestureSingle *gesture);

Возвращает TRUE, если жест срабатывает только при нажатии на сенсорный экран.

Параметры

жест

a GtkGestureSingle

Возвращает

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, то будут обрабатываться и события мыши.

Параметры

жест

a GtkGestureSingle

touch_only

обрабатывать только события касания для gesture

С: 3.14

gtk_gesture_single_get_button ()

guint
gtk_gesture_single_get_button (GtkGestureSingle *gesture);

Возвращает номер кнопки gesture, или 0, если gesture реагирует на любое нажатие кнопки.

Параметры

жест

a GtkGestureSingle

Возвращает

Номер кнопки или 0 для любой кнопки

С: 3.14

gtk_gesture_single_set_button ()

void
gtk_gesture_single_set_button (GtkGestureSingle *gesture,
                               guint button);

Устанавливает номер кнопки gesture, за которым следит. Если это значение не равно 0, любое нажатие кнопки с другим номером будет проигнорировано. Сенсорные события подразумевают соответствие кнопке 1.

Параметры

жест

a GtkGestureSingle

кнопка

номер кнопки, за которой следить, или 0 для любой кнопки

С: 3.14

gtk_gesture_single_get_current_button ()

guint
gtk_gesture_single_get_current_button (GtkGestureSingle *gesture);

Возвращает номер кнопки, которая в данный момент взаимодействует с gesture, или 0, если такой нет.

Параметры

жест

a GtkGestureSingle

Возвращает

Текущий номер кнопки

С: 3.14

gtk_gesture_single_get_current_sequence ()

GdkEventSequence *
gtk_gesture_single_get_current_sequence
                               (GtkGestureSingle *gesture);

Возвращает последовательность событий, которая в данный момент взаимодействует с gesture. Это имеет значение только если gtk_gesture_is_active() возвращает TRUE.

Параметры

жест

a GtkGestureSingle

Возвращает

текущая последовательность.

[nullable]

С: 3.14

Типы и значения

GtkGestureSingle

typedef struct _GtkGestureSingle GtkGestureSingle;

Подробное описание свойств

Свойство “button”

  “button”                   guint

Номер кнопки мыши, за которой следить, или 0, чтобы следить за любой кнопкой.

Флаги: Чтение / Запись

Значение по умолчанию: 1

С: 3.14

Свойство “exclusive”

  “exclusive”                gboolean

Является ли жест эксклюзивным. Эксклюзивные жесты отслеживают только события указателя и эмулируемые события указателя.

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

С: 3.14

Свойство “touch-only”

  “touch-only”               gboolean

Обрабатывает ли жест только сенсорные события.

Флаги: Чтение / Запись

Значение по умолчанию: 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.22/GtkGestureSingle.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API