Класс QGestureEvent

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

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

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

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

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

• 1 свойство, унаследованное от QEvent
• 1 открытая переменная, унаследованная от QEvent
• 1 статический открытый член, унаследованный от QEvent
• 2 защищенных переменных, унаследованных от QEvent

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

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

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

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

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

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

Для ознакомления с обработкой жестов в Qt и использованием жестов в приложениях см. документ Жесты в виджетах и графическом представлении.

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

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

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

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

[virtual] 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.

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

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

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

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

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

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

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

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

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

QWidget *QGestureEvent::widget() const

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