Класс 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() |
- 34 открытые функции, унаследованные от QObject
Дополнительные унаследованные члены
- 1 открытый слот, унаследованный от QObject
- 2 сигналов, унаследованных от QObject
- 1 открытая переменная, унаследованная от QObject
- 10 статических открытых членов, унаследованных от QObject
- 9 защищенных функций, унаследованных от QObject
- 2 защищенных переменных, унаследованных от 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/archives/qt-5.11/qgesture.html
