Класс QGestureEvent

Класс QGestureEvent предоставляет описание сработавших жестов. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

• 6 открытых функций, унаследованных от QEvent

Дополнительные унаследованные члены

• 1 свойство, унаследованное от QEvent
• 1 статический открытый член, унаследованный от QEvent

Подробное описание

Класс QGestureEvent предоставляет описание сработавших жестов.

Класс QGestureEvent содержит список жестов, который можно получить с помощью функции gestures().

Жесты могут быть активными или отменёнными. Список текущих активных жестов можно получить с помощью функции activeGestures(). Список ранее активных и отменённых жестов доступен через функцию canceledGestures(). Жест может быть отменён, например, если окно теряет фокус, или из-за таймаута, или по другим причинам.

Если обработчик события не принимает событие, вызывая общую функцию QEvent::accept(), все отдельные объекты QGesture, которые не были приняты и находились в состоянии Qt::GestureStarted, будут переданы вверх по цепочке родительских виджетов, пока какой-то виджет не примет их, вызвав QGestureEvent::accept() для каждого из них, или обработчик событий не потребляет событие.

Дополнительная информация

Обзор обработки жестов в Qt и информация об использовании жестов в ваших приложениях см. в документе Gestures in Widgets and Graphics View.

См. также QGesture, QGestureRecognizer, QWidget::grabGesture() и QGraphicsObject::grabGesture().

Документация по функциям-членам

QGestureEvent::QGestureEvent(const QList<QGesture *> &gestures)

Создаёт новый QGestureEvent, содержащий список gestures.

QGestureEvent::~QGestureEvent()

Удаляет QGestureEvent.

void QGestureEvent::accept(QGesture *gesture)

Устанавливает флаг принятия для данного объекта gesture, что эквивалентно вызову setAccepted(gesture, true).

Установление флага принятия указывает, что получатель события хочет этот жест. Нежелательные жесты могут быть переданы родительскому виджету.

См. также QGestureEvent::ignore().

void QGestureEvent::accept(Qt::GestureType gestureType)

Устанавливает флаг принятия для данного gestureType, что эквивалентно вызову setAccepted(gestureType, true).

Установление флага принятия указывает, что получатель события хочет этот жест. Нежелательные жесты могут быть переданы родительскому виджету.

См. также QGestureEvent::ignore().

QList<QGesture *> QGestureEvent::activeGestures() const

Возвращает список активных (не отменённых) жестов.

QList<QGesture *> QGestureEvent::canceledGestures() const

Возвращает список отменённых жестов.

QGesture *QGestureEvent::gesture(Qt::GestureType type) const

Возвращает объект жеста по type.

QList<QGesture *> QGestureEvent::gestures() const

Возвращает все жесты, доставленные в событии.

void QGestureEvent::ignore(QGesture *gesture)

Сбрасывает флаг принятия для данного объекта gesture, что эквивалентно вызову setAccepted(gesture, false).

Сброс флага принятия указывает, что получатель события не хочет этот жест. Нежелательные жесты могут быть переданы родительскому виджету.

См. также QGestureEvent::accept().

void QGestureEvent::ignore(Qt::GestureType gestureType)

Сбрасывает флаг принятия для данного gestureType, что эквивалентно вызову setAccepted(gesture, false).

Сброс флага принятия указывает, что получатель события не хочет этот жест. Нежелательные жесты могут быть переданы родительскому виджету.

См. также QGestureEvent::accept().

bool QGestureEvent::isAccepted(QGesture *gesture) const

Возвращает true если gesture принят; в противном случае возвращает false.

bool QGestureEvent::isAccepted(Qt::GestureType gestureType) const

Возвращает true если жест типа gestureType принят; в противном случае возвращает false.

QPointF QGestureEvent::mapToGraphicsScene(const QPointF &gesturePoint) const

Возвращает координаты в пространстве сцены, если gesturePoint находится внутри графического виджета.

Эта функция может быть полезна, когда событие жеста доставляется в QGraphicsObject, чтобы перевести точку в координатах экрана в координаты пространства сцены.

См. также QPointF::isNull().

void QGestureEvent::setAccepted(QGesture *gesture, bool value)

Устанавливает флаг принятия для данного объекта gesture на заданное значение value.

Установка флага accept указывает, что получатель события хочет получить жест. Нежелательные жесты могут быть переданы родительскому виджету.

По умолчанию, жесты в событиях типа QEvent::Gesture принимаются, а жесты в событиях QEvent::GestureOverride игнорируются.

Для удобства, флаг accept можно установить с помощью accept(gesture), и сбросить с помощью ignore(gesture).

См. также isAccepted().

void QGestureEvent::setAccepted(Qt::GestureType gestureType, bool value)

Устанавливает флаг accept для данного объекта gestureType в указанное значение value.

Установка флага accept указывает, что получатель события хочет получать жесты указанного типа, gestureType. Нежелательные жесты могут быть переданы родительскому виджету.

По умолчанию, жесты в событиях типа QEvent::Gesture принимаются, а жесты в событиях QEvent::GestureOverride игнорируются.

Для удобства, флаг accept можно также установить с помощью accept(gestureType), и сбросить с помощью ignore(gestureType).

QWidget *QGestureEvent::widget() const

Возвращает виджет, на котором произошло событие.