Класс QGesture
Класс QGesture представляет жест, содержащий свойства, описывающие соответствующий ввод пользователя. Подробнее...
| Заголовок: | #include <QGesture> |
| qmake: | QT += widgets |
| С момента: | Qt 4.6 |
| Наследует от: | QObject |
| Наследуется для: | QPanGesture, QPinchGesture, QSwipeGesture, QTapAndHoldGesture и QTapGesture |
Типы
| перечисление | GestureCancelPolicy { CancelNone, CancelAllInContext } |
Свойства
|
- 1 свойство унаследовано от QObject
Открытые функции
| 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() |
- 31 открытая функция унаследована от QObject
Статические открытые члены
| const QMetaObject | staticMetaObject |
- 9 статических открытых членов унаследовано от QObject
Дополнительные унаследованные члены
- 1 открытый слот унаследован от QObject
- 2 сигналы унаследованы от QObject
- 9 защищенные функции унаследованы от QObject
Подробное описание
Класс QGesture представляет жест, содержащий свойства, описывающие соответствующий ввод пользователя.
Объекты жестов не создаются разработчиками напрямую. Они создаются объектом 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) |
gestureType : const Qt::GestureType
Это свойство содержит тип жеста
Функции доступа:
| Qt::GestureType | gestureType() const |
hasHotSpot : const bool
Это свойство содержит значение, указывающее, имеет ли жест горячую точку
Функции доступа:
| bool | hasHotSpot() const |
hotSpot : QPointF
Это свойство содержит точку, используемую для поиска получателя события жеста.
Горячая точка — это точка в глобальной системе координат. Используйте QWidget::mapFromGlobal() или QGestureEvent::mapToGraphicsScene() для получения локальной горячей точки.
Горячая точка должна устанавливаться распознавателем жеста, чтобы обеспечить доставку события жеста в QGraphicsObject.
Функции доступа:
| QPointF | hotSpot() const |
| void | setHotSpot(const QPointF &value) |
| void | unsetHotSpot() |
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-5.12/qgesture.html
