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) |
| 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.
Документация по типам членов
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-6.1/qpinchgesture.html
