Класс 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 |
Свойства
|
|
Открытые функции
| virtual | ~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.
Документация по типам членов
перечисление QPinchGesture::ChangeFlagфлаги QPinchGesture::ChangeFlags
Это перечисление описывает изменения, которые могут произойти в свойствах объекта жеста.
| Константа | Значение | Описание |
|---|---|---|
QPinchGesture::ScaleFactorChanged |
0x1 |
Изменился коэффициент масштаба, хранящийся в scaleFactor. |
QPinchGesture::RotationAngleChanged |
0x2 |
Изменился угол поворота, хранящийся в rotationAngle. |
QPinchGesture::CenterPointChanged |
0x4 |
Изменилась центральная точка, хранящаяся в centerPoint. |
Тип ChangeFlags — это тип-синоним для QFlags<ChangeFlag>. Он хранит результат побитового ИЛИ сочетания значений ChangeFlag.
См. также changeFlags и totalChangeFlags.
END_OF_DOCUMENT_MARKERДокументация свойств
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.0/qpinchgesture.html
