Класс 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) | |
| virtual | ~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() |
Подробное описание
Объекты жестов не создаются разработчиками напрямую. Они создаются объектом QGestureRecognizer, зарегистрированным в приложении; см. QGestureRecognizer::registerRecognizer().
Для обзора обработки жестов в Qt и получения информации об использовании жестов в ваших приложениях см. документ Жесты в виджетах и графическом представлении.
Свойства жеста
Класс имеет список свойств, которые могут быть запрошены пользователем, чтобы получить некоторые специфичные для жеста аргументы. Например, у жеста масштабирования есть коэффициент масштабирования, который экспонируется как свойство.
Разработчики пользовательских распознавателей жестов могут добавлять дополнительные свойства для предоставления дополнительной информации о жесте. Это можно сделать, добавив новые динамические свойства в объект 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.2/qgesture.html
