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” может быть небезопасной, поскольку обратный вызов может быть выполнен до того, как другой жест узнает о последовательности. Безопасный способ сделать это может быть следующим:

static void
first_gesture_begin_cb (GtkGesture       *first_gesture,
                        GdkEventSequence *sequence,
                        gpointer          user_data)
{
  gtk_gesture_set_sequence_state (first_gesture, sequence, GTK_EVENT_SEQUENCE_CLAIMED);
  gtk_gesture_set_sequence_state (second_gesture, sequence, GTK_EVENT_SEQUENCE_DENIED);
}

static void
second_gesture_begin_cb (GtkGesture       *second_gesture,
                         GdkEventSequence *sequence,
                         gpointer          user_data)
{
  if (gtk_gesture_get_sequence_state (first_gesture, sequence) == GTK_EVENT_SEQUENCE_CLAIMED)
    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.

Обратите внимание, что возвращаемый указатель действителен только до тех пор, пока sequence все еще интерпретируется gesture. Если есть сомнения, необходимо скопировать событие.

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