Класс QGesture
Класс QGesture представляет жест, содержащий свойства, описывающие соответствующий ввод пользователя. Подробнее...
| Заголовок: | #include <QGesture> |
| qmake: | QT += widgets |
| С момента: | Qt 4.6 |
| Наследует: | QObject |
| Наследуется от: | QPanGesture, QPinchGesture, QSwipeGesture, QTapAndHoldGesture и QTapGesture |
Типы public
| перечисление | GestureCancelPolicy { CancelNone, CancelAllInContext } |
Свойства
|
- 1 свойство унаследовано от QObject
Public-функции
| QGesture(QObject *parent = Q_NULLPTR) | |
| ~QGesture() | |
| GestureCancelPolicy | gestureCancelPolicy() const |
| Qt::GestureType | gestureType() const |
| bool | hasHotSpot() const |
| QPointF | hotSpot() const |
| void | setGestureCancelPolicy(GestureCancelPolicy policy) |
| void | setHotSpot(const QPointF &value) |
| Qt::GestureState | state() const |
| void | unsetHotSpot() |
- 31 public-функция унаследована от QObject
Дополнительные унаследованные члены
- 1 public-слот унаследован от QObject
- 2 сигнала унаследованы от QObject
- 11 статических public-членов унаследованы от 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 может автоматически отменять другие жесты, которые относятся к другим целевым объектам. Политика обычно устанавливается так, чтобы не отменять другие жесты, и может быть установлена так, чтобы отменять все активные жесты в контексте. Например, для всех дочерних виджетов.
Функции доступа:
| GestureCancelPolicy | gestureCancelPolicy() const |
| void | setGestureCancelPolicy(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 = Q_NULLPTR)
Конструирует новый объект жеста с заданным parent.
QGesture объекты создаются распознавателями жестов в функции QGestureRecognizer::create().
QGesture::~QGesture()
Уничтожает объект жеста.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qgesture.html
