Класс QPinchGesture
Класс QPinchGesture описывает жест щипка, выполненный пользователем. Подробнее...
| Заголовок: | #include <QPinchGesture> |
| CMake: | find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Наследует: | QGesture |
Типы публичного доступа
| Перечисление | 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) |
Подробное описание
Жест щипка — это вид ввода с помощью сенсорного экрана, при котором пользователь, как правило, касается двумя точками устройства ввода большим и указательным пальцами, прежде чем приблизить их друг к другу или развести, чтобы изменить коэффициент масштабирования, масштаб или уровень детализации пользовательского интерфейса.
Обзор обработки жестов в 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-6.2/qpinchgesture.html
