Класс QGesture
Класс QGesture представляет жесты, содержащие свойства, описывающие соответствующий ввод пользователя. Подробнее...
| Заголовок: | #include <QGesture> |
| CMake: | find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Наследуется от: | QObject |
| Наследует: | QPanGesture, QPinchGesture, QSwipeGesture, QTapAndHoldGesture и QTapGesture |
Типы публичного доступа
| Перечисление | GestureCancelPolicy { CancelNone, CancelAllInContext } |
Свойства
|
Функции публичного доступа
| QGesture(QObject *parent = nullptr) | |
| виртуальный | ~QGesture() |
| QGesture::GestureCancelPolicy | gestureCancelPolicy() const |
| Qt::GestureType | gestureType() const |
| bool | hasHotSpot() const |
| QPointF | hotSpot() const |
| void | setGestureCancelPolicy(QGesture::GestureCancelPolicy policy) |
| void | setHotSpot(const QPointF &value) |
| Qt::GestureState | state() const |
| void | unsetHotSpot() |
Подробное описание
Объекты QGesture создаются не напрямую разработчиками. Они создаются объектом QGestureRecognizer, зарегистрированным в приложении; см. QGestureRecognizer::registerRecognizer().
Обзор обработки жестов в Qt и информация о работе с жестами в ваших приложениях приведены в документе Gestures in Widgets and Graphics View.
Свойства жестов
Класс имеет список свойств, которые пользователь может запросить, чтобы получить некоторые специфичные для жестов параметры. Например, у жеста pinch есть масштабный коэффициент, который представлен как свойство.
Разработчики пользовательских распознавателей жестов могут добавить дополнительные свойства, чтобы предоставить дополнительную информацию о жесте. Это можно сделать, добавив новые динамические свойства в объект QGesture или путем наследования от класса QGesture (или одного из его подклассов).
Жизненный цикл объекта QGesture
Экземпляр QGesture создается неявно при необходимости и принадлежит Qt. Разработчики не должны уничтожать или хранить их для последующего использования, так как Qt может уничтожать конкретные экземпляры и создавать новые для замены.
Зарегистрированный распознаватель жестов отслеживает события ввода для целевого объекта через его функцию recognize(), обновляя свойства объекта жеста по мере необходимости.
Объект жеста может быть передан целевому объекту в событии QGestureEvent, если соответствующий жест активен или только что был отменён. Каждое переданное событие содержит список объектов жестов, так как поддержка более одного жеста может быть включена для целевого объекта. Из-за способа обработки событий в Qt события жестов могут быть отфильтрованы другими объектами.
См. также QGestureEvent и QGestureRecognizer.
Документация типов членов
перечисление QGesture::GestureCancelPolicy
Это перечисление описывает, как принятие жеста может автоматически отменить другие жесты.
| Константа | Значение | Описание |
|---|---|---|
QGesture::CancelNone |
0 |
При принятии этого жеста другие жесты не будут затронуты. |
QGesture::CancelAllInContext |
1 |
При принятии этого жеста все активные в контексте жесты (учитывая Qt::GestureFlag, указанные при подписке на жест) будут отменены. |
Документация по свойствам
gestureCancelPolicy : QGesture::GestureCancelPolicy
Это свойство содержит политику для определения того, что происходит при принятии жеста
При принятии одного жеста Qt может автоматически отменить другие жесты, относящиеся к другим целевым объектам. Политика обычно устанавливается так, чтобы не отменять другие жесты, и может быть установлена для отмены всех активных жестов в контексте. Например, для всех дочерних виджетов.
Функции доступа:
| QGesture::GestureCancelPolicy | gestureCancelPolicy() const |
| void | setGestureCancelPolicy(QGesture::GestureCancelPolicy policy) |
[read-only] gestureType : const Qt::GestureType
Это свойство содержит тип жеста
Функции доступа:
| Qt::GestureType | gestureType() const |
[read-only] hasHotSpot : const bool
Это свойство содержит информацию о наличии точки «горячей точки» для жеста
Функции доступа:
| bool | hasHotSpot() const |
hotSpot : QPointF
Это свойство содержит точку, используемую для поиска получателя события жеста.
Точка «горячей точки» находится в глобальной системе координат. Используйте QWidget::mapFromGlobal() или QGestureEvent::mapToGraphicsScene() для получения локальной точки «горячей точки».
Точка «горячей точки» должна быть установлена распознавателем жеста, чтобы разрешить доставку события жеста объекту QGraphicsObject.
Функции доступа:
| QPointF | hotSpot() const |
| void | setHotSpot(const QPointF &value) |
| void | unsetHotSpot() |
[read-only] state : const Qt::GestureState
Это свойство содержит текущее состояние жеста
Функции доступа:
| Qt::GestureState | state() const |
Документация по функциям членов
QGesture::QGesture(QObject *parent = nullptr)
Конструирует новый объект жеста с заданным parent.
Объекты QGesture создаются распознавателями жестов в функции QGestureRecognizer::create().
[virtual] QGesture::~QGesture()
Уничтожает объект жеста.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qgesture.html
