GtkGesture

gtk_gesture_get_device ()

GdkDevice *
gtk_gesture_get_device (GtkGesture *gesture);

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

gtk_gesture_is_active ()

gboolean
gtk_gesture_is_active (GtkGesture *gesture);

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

gtk_gesture_is_recognized ()

gboolean
gtk_gesture_is_recognized (GtkGesture *gesture);

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

gtk_gesture_get_sequence_state ()

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

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

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);
}

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

gtk_gesture_set_state ()

gboolean
gtk_gesture_set_state (GtkGesture *gesture,
                       GtkEventSequenceState state);

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

gtk_gesture_get_sequences ()

GList *
gtk_gesture_get_sequences (GtkGesture *gesture);

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

gtk_gesture_handles_sequence ()

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

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

gtk_gesture_get_last_updated_sequence ()

GdkEventSequence *
gtk_gesture_get_last_updated_sequence (GtkGesture *gesture);

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

gtk_gesture_get_last_event ()

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,
                       double *x,
                       double *y);

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

gtk_gesture_get_bounding_box ()

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

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

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

gtk_gesture_get_bounding_box_center ()

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

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

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.

gtk_gesture_ungroup ()

void
gtk_gesture_ungroup (GtkGesture *gesture);

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

gtk_gesture_get_group ()

GList *
gtk_gesture_get_group (GtkGesture *gesture);

Возвращает все жесты в группе gesture

gtk_gesture_is_grouped_with ()

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

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