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_ACCEPTED);
  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_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() для получения более подробной информации о состояниях последовательностей.

Since: 3.14

gtk_gesture_get_sequences ()

GList *
gtk_gesture_get_sequences (GtkGesture *gesture);

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

Since: 3.14

gtk_gesture_handles_sequence ()

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

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

Since: 3.14

gtk_gesture_get_last_updated_sequence ()

GdkEventSequence *
gtk_gesture_get_last_updated_sequence (GtkGesture *gesture);

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

Since: 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 последними сохранёнными координатами для этой последовательности событий. Координаты всегда относительны к области виджета.

Since: 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