Класс 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 и информация о применении жестов в ваших приложениях см. в документе Жесты в виджетах и графическом представлении.
Вместо многократного применения одного и того же жеста щипка пользователь может продолжать касаться устройства ввода в одном месте и применить второе касание к новой точке, продолжая жест. В этом случае события жестов будут продолжать поступать в целевой объект, содержащий экземпляр QPinchGesture в состоянии Qt::GestureUpdated.
См. также QPanGesture и QSwipeGesture.
Документация по типам членов
enum QPinchGesture::ChangeFlagflags 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.14/qpinchgesture.html