GtkGesture

gtk_gesture_get_device ()

GdkDevice *
gtk_gesture_get_device (GtkGesture *gesture);

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

С версии: 3.14

gtk_gesture_get_window ()

GdkWindow *
gtk_gesture_get_window (GtkGesture *gesture);

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

С версии: 3.14

gtk_gesture_set_window ()

void
gtk_gesture_set_window (GtkGesture *gesture,
                        GdkWindow *window);

Устанавливает определённое окно для получения событий, таким образом gesture будет эффективно обрабатывать только события, предназначенные для window или его потомка. window должно относиться к gtk_event_controller_get_widget().

С версии: 3.14

gtk_gesture_is_active ()

gboolean
gtk_gesture_is_active (GtkGesture *gesture);

Возвращает TRUE, если жест в данный момент активен. Жест активен, пока с ним взаимодействуют последовательности касаний.

С версии: 3.14

gtk_gesture_is_recognized ()

gboolean
gtk_gesture_is_recognized (GtkGesture *gesture);

Возвращает TRUE, если жест в данный момент распознан. Жест распознаётся, если существует столько же взаимодействующих последовательностей касаний, сколько требуется gesture, и “check” вернул TRUE для последовательностей, которые в данный момент интерпретируются.

С версии: 3.14

gtk_gesture_get_sequence_state ()

GtkEventSequenceState
gtk_gesture_get_sequence_state (GtkGesture *gesture,
                                GdkEventSequence *sequence);

Возвращает состояние sequence, как видно из gesture.

С версии: 3.14

gtk_gesture_set_sequence_state ()

gboolean
gtk_gesture_set_sequence_state (GtkGesture *gesture,
                                GdkEventSequence *sequence,
                                GtkEventSequenceState state);

Устанавливает состояние sequence в gesture. Последовательности начинаются в состоянии GTK_EVENT_SEQUENCE_NONE, и когда они меняют состояние, они никогда не могут вернуться к этому состоянию. Аналогично, последовательности в состоянии GTK_EVENT_SEQUENCE_DENIED не могут вернуться к состоянию, не являющемуся запрещённым. С учётом этих правил, время жизни последовательности событий ограничивается следующими четырьмя:

Примечание: Из-за порядка обработки событий, установка состояния на другом жесте внутри обработчика сигнала “begin” может быть небезопасной, поскольку обратный вызов может быть выполнен до того, как другой жест узнает о последовательности. Безопасный способ выполнить это может быть:

staticvoid
first_gesture_begin_cb(GtkGesture*first_gesture,
GdkEventSequence*sequence,
gpointer          user_data)
{
gtk_gesture_set_sequence_state(first_gesture, sequence, GTK_EVENT_SEQUENCE_ACCEPTED);
gtk_gesture_set_sequence_state(second_gesture, sequence, GTK_EVENT_SEQUENCE_DENIED);
}

staticvoid
second_gesture_begin_cb(GtkGesture*second_gesture,
GdkEventSequence*sequence,
gpointer          user_data)
{
if(gtk_gesture_get_sequence_state(first_gesture, sequence)== GTK_EVENT_SEQUENCE_ACCEPTED)
gtk_gesture_set_sequence_state(second_gesture, sequence, GTK_EVENT_SEQUENCE_DENIED);
}

Если оба жеста находятся в одной группе, просто установите состояние на жесте, генерирующем событие, последовательность уже будет инициализирована в глобальное состояние группы, когда второй жест обработает событие.

С версии: 3.14

gtk_gesture_set_state ()

gboolean
gtk_gesture_set_state (GtkGesture *gesture,
                       GtkEventSequenceState state);

Устанавливает состояние всех последовательностей, с которыми gesture в данный момент взаимодействует. См. gtk_gesture_set_sequence_state() для получения более подробной информации о состояниях последовательностей.

С: 3.14

gtk_gesture_get_sequences ()

GList *
gtk_gesture_get_sequences (GtkGesture *gesture);

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

С: 3.14

gtk_gesture_handles_sequence ()

gboolean
gtk_gesture_handles_sequence (GtkGesture *gesture,
                              GdkEventSequence *sequence);

Возвращает TRUE, если gesture в данный момент обрабатывает события, соответствующие sequence.

С: 3.14

gtk_gesture_get_last_updated_sequence ()

GdkEventSequence *
gtk_gesture_get_last_updated_sequence (GtkGesture *gesture);

Возвращает GdkEventSequence, который был последним обновлён в gesture.

С: 3.14

gtk_gesture_get_last_event ()

const GdkEvent *
gtk_gesture_get_last_event (GtkGesture *gesture,
                            GdkEventSequence *sequence);

Возвращает последнее обработанное событие для sequence.

gtk_gesture_get_point ()

gboolean
gtk_gesture_get_point (GtkGesture *gesture,
                       GdkEventSequence *sequence,
                       gdouble *x,
                       gdouble *y);

Если sequence в данный момент интерпретируется gesture, эта функция возвращает TRUE и заполняет x и y последними сохранёнными координатами для этой последовательности событий. Координаты всегда относительны к выделению виджета.

С: 3.14

gtk_gesture_get_bounding-box ()

gboolean
gtk_gesture_get_bounding_box (GtkGesture *gesture,
                              GdkRectangle *rect);

Если в настоящее время обрабатываются последовательности касаний с помощью gesture, эта функция возвращает TRUE и заполняет rect прямоугольником, содержащим все активные касания. В противном случае будет возвращено FALSE.

Примечание: Эта функция может давать непредсказуемые результаты при работе с жестами на сенсорной панели. Поскольку нет корреляции между физическими и пиксельными расстояниями, эти жесты будут выглядеть как ограниченные бесконечно малой областью, поэтому ширина и высота rect будут равны 0 независимо от количества точек касания.

С: 3.14

gtk_gesture_get_bounding-box_center ()

gboolean
gtk_gesture_get_bounding_box_center (GtkGesture *gesture,
                                     gdouble *x,
                                     gdouble *y);

Если в настоящее время обрабатываются последовательности касаний с помощью gesture, эта функция возвращает TRUE и заполняет x и y координатами центра прямоугольника, содержащего все активные касания. В противном случае будет возвращено FALSE.

С: 3.14

gtk_gesture_group ()

void
gtk_gesture_group (GtkGesture *group_gesture,
                   GtkGesture *gesture);

Добавляет gesture в ту же группу, что и group_gesture. По умолчанию жесты изолированы в своих группах.

При группировании жестов состояние GdkEventSequences сохраняется синхронизированным для всех из них, поэтому вызов gtk_gesture_set_sequence_state() для одного из них передаст то же значение другим.

Группы также выполняют «неявный захват» последовательностей, если состояние GdkEventSequence устанавливается в GTK_EVENT_SEQUENCE_CLAIMED для одной группы, все остальные группы жестов, прикрепленные к одному GtkWidget, изменят состояние для этой последовательности на GTK_EVENT_SEQUENCE_DENIED.

С: 3.14

gtk_gesture_ungroup ()

void
gtk_gesture_ungroup (GtkGesture *gesture);

Разделяет gesture в изолированную группу.

С: 3.14

gtk_gesture_get_group ()

GList *
gtk_gesture_get_group (GtkGesture *gesture);

Возвращает список всех жестов в группе gesture.

С: 3.14

gtk_gesture_is_grouped_with ()

gboolean
gtk_gesture_is_grouped_with (GtkGesture *gesture,
                             GtkGesture *other);

Возвращает TRUE, если оба жеста относятся к одной группе.

С: 3.14