Класс QPinchGesture
Класс QPinchGesture описывает жест пинцета, сделанный пользователем. Подробнее...
| Заголовок: | #include <QPinchGesture> |
| qmake: | QT += widgets |
| С момента: | Qt 4.6 |
| Наследует: | QGesture |
Этот класс был представлен в Qt 4.6.
Общие типы
| перечисление | ChangeFlag { ScaleFactorChanged, RotationAngleChanged, CenterPointChanged } |
| флаги | ChangeFlags |
Свойства
|
|
Открытые функции
| виртуальный | ~QPinchGesture() |
| QPointF | centerPoint() const |
| QPinchGesture::ChangeFlags | changeFlags() const |
| QPointF | lastCenterPoint() const |
| qreal | lastRotationAngle() const |
| qreal | lastScaleFactor() const |
| qreal | rotationAngle() const |
| qreal | scaleFactor() const |
| void | setCenterPoint(const QPointF &value) |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
| void | setLastCenterPoint(const QPointF &value) |
| void | setLastRotationAngle(qreal value) |
| void | setLastScaleFactor(qreal value) |
| void | setRotationAngle(qreal value) |
| void | setScaleFactor(qreal value) |
| void | setStartCenterPoint(const QPointF &value) |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
| void | setTotalRotationAngle(qreal value) |
| void | setTotalScaleFactor(qreal value) |
| QPointF | startCenterPoint() const |
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| qreal | totalRotationAngle() const |
| qreal | totalScaleFactor() const |
Подробное описание
Жест пинцета — это тип ввода с сенсорного экрана, при котором пользователь обычно нажимает на входное устройство двумя точками (большим и указательным пальцами), а затем приближает или отдаляет их, чтобы изменить масштаб, масштабирование или уровень детализации пользовательского интерфейса.
Обзор обработки жестов в Qt и информацию о использовании жестов в ваших приложениях см. в документе Gestures in Widgets and Graphics View.
Вместо многократного применения одного и того же жеста пинцета пользователь может продолжать касаться входного устройства в одном месте и наложить второе касание в новой точке, продолжая жест. В этом случае события жеста будут продолжать передаваться целевому объекту, содержащему экземпляр QPinchGesture в состоянии Qt::GestureUpdated.
См. также QPanGesture и QSwipeGesture.
Документация по типам членов
перечисление QPinchGesture::ChangeFlagфлаги QPinchGesture::ChangeFlags
Это перечисление описывает изменения, которые могут произойти в свойствах объекта жеста.
| Константа | Значение | Описание |
|---|---|---|
QPinchGesture::ScaleFactorChanged |
0x1 |
Изменился масштабный множитель, хранящийся в scaleFactor. |
QPinchGesture::RotationAngleChanged |
0x2 |
Изменился угол поворота, хранящийся в rotationAngle. |
QPinchGesture::CenterPointChanged |
0x4 |
Изменилась центральная точка, хранящаяся в centerPoint. |
Тип ChangeFlags — это псевдоним для QFlags<ChangeFlag>. Он хранит логическое ИЛИ комбинацию значений ChangeFlag.
См. также changeFlags и totalChangeFlags.
Документация свойств
centerPoint : QPointF
Это свойство содержит текущую центральную точку.
Центральная точка — это середина между двумя входными точками в жесте.
Функции доступа:
| QPointF | centerPoint() const |
| void | setCenterPoint(const QPointF &value) |
См. также startCenterPoint и lastCenterPoint.
changeFlags : ChangeFlags
Это свойство содержит свойства жеста, которые изменились на текущем шаге.
Это свойство указывает, какие другие свойства изменились с момента предыдущего события жеста, содержащего информацию об этом жесте. Вы можете использовать эту информацию для определения, какие аспекты вашего пользовательского интерфейса необходимо обновить.
Функции доступа:
| QPinchGesture::ChangeFlags | changeFlags() const |
| void | setChangeFlags(QPinchGesture::ChangeFlags value) |
См. также totalChangeFlags, scaleFactor, rotationAngle и centerPoint.
lastCenterPoint : QPointF
Это свойство содержит последнюю позицию центральной точки, записанную для данного жеста.
Функции доступа:
| QPointF | lastCenterPoint() const |
| void | setLastCenterPoint(const QPointF &value) |
См. также centerPoint и startCenterPoint.
lastRotationAngle : qreal
Это свойство содержит последний угол, охваченный движением жеста.
Последний угол поворота — это угол, как он был указан в свойстве rotationAngle, когда для этого жеста было доставлено предыдущее событие жеста.
Функции доступа:
| qreal | lastRotationAngle() const |
| void | setLastRotationAngle(qreal value) |
См. также rotationAngle и totalRotationAngle.
lastScaleFactor : qreal
Это свойство содержит последний коэффициент масштабирования, записанный для данного жеста.
Последний коэффициент масштабирования содержит коэффициент масштабирования, который был указан в свойстве scaleFactor, когда предыдущее событие жеста содержало информацию об этом жесте.
Если предыдущее событие не было доставлено с информацией об этом жесте (т.е., этот объект жеста содержит информацию о первом движении в жесте), то это свойство содержит ноль.
Функции доступа:
| qreal | lastScaleFactor() const |
| void | setLastScaleFactor(qreal value) |
См. также scaleFactor и totalScaleFactor.
rotationAngle : qreal
Это свойство содержит угол, охваченный движением жеста.
Функции доступа:
| qreal | rotationAngle() const |
| void | setRotationAngle(qreal value) |
См. также totalRotationAngle и lastRotationAngle.
scaleFactor : qreal
Это свойство содержит текущий коэффициент масштабирования.
Коэффициент масштабирования измеряет коэффициент масштабирования, связанный с расстоянием между двумя входами пользователя на сенсорном устройстве.
Функции доступа:
| qreal | scaleFactor() const |
| void | setScaleFactor(qreal value) |
См. также totalScaleFactor и lastScaleFactor.
startCenterPoint : QPointF
Это свойство содержит начальную позицию центральной точки.
Функции доступа:
| QPointF | startCenterPoint() const |
| void | setStartCenterPoint(const QPointF &value) |
См. также centerPoint и lastCenterPoint.
totalChangeFlags : ChangeFlags
Это свойство содержит свойства жеста, которые изменились.
Это свойство указывает, какие из других свойств изменились с начала жеста. Вы можете использовать эту информацию для определения, какие аспекты вашего пользовательского интерфейса необходимо обновить.
Функции доступа:
| QPinchGesture::ChangeFlags | totalChangeFlags() const |
| void | setTotalChangeFlags(QPinchGesture::ChangeFlags value) |
См. также changeFlags, scaleFactor, rotationAngle и centerPoint.
totalRotationAngle : qreal
Это свойство содержит общий угол, охваченный жестом.
Этот общий угол измеряет полный угол, охваченный жестом. Обычно он равен значению, содержащемуся в свойстве rotationAngle, за исключением случаев, когда пользователь выполняет несколько поворотов, удаляя и перемещая одну из точек касания, как описано выше. В этом случае общий угол будет суммой углов поворота для нескольких этапов жеста.
Функции доступа:
| qreal | totalRotationAngle() const |
| void | setTotalRotationAngle(qreal value) |
См. также rotationAngle и lastRotationAngle.
totalScaleFactor : qreal
Это свойство содержит общий коэффициент масштабирования.
Общий коэффициент масштабирования измеряет общее изменение коэффициента масштабирования от начального значения до текущего коэффициента масштабирования.
Функции доступа:
| qreal | totalScaleFactor() const |
| void | setTotalScaleFactor(qreal value) |
См. также scaleFactor и lastScaleFactor.
Документация членов-функций
[virtual] QPinchGesture::~QPinchGesture()
Деструктор.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qpinchgesture.html