Класс QEventPoint
Класс QEventPoint предоставляет информацию о точке в QPointerEvent. Подробнее...
| Header: | #include <QEventPoint> |
| CMake: | find_package(Qt6 COMPONENTS Gui REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Since: | Qt 6.0 |
Открытые типы
| enum | State { Unknown, Stationary, Pressed, Updated, Released } |
| flags | States |
Свойства
|
|
Открытые функции
| QEventPoint(QEventPoint &&other) | |
| QEventPoint(const QEventPoint &other) | |
| QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition) | |
| QEventPoint & | operator=(QEventPoint &&other) |
| QEventPoint & | operator=(const QEventPoint &other) |
| ~QEventPoint() | |
| const QPointingDevice * | device() const |
| QSizeF | ellipseDiameters() const |
| QPointF | globalGrabPosition() const |
| QPointF | globalLastPosition() const |
| QPointF | globalPosition() const |
| QPointF | globalPressPosition() const |
| QPointF | grabPosition() const |
| int | id() const |
| bool | isAccepted() const |
| QPointF | lastPosition() const |
| ulong | lastTimestamp() const |
| QPointF | normalizedPosition() const |
| QPointF | position() const |
| QPointF | pressPosition() const |
| ulong | pressTimestamp() const |
| qreal | pressure() const |
| qreal | rotation() const |
| QPointF | sceneGrabPosition() const |
| QPointF | sceneLastPosition() const |
| QPointF | scenePosition() const |
| QPointF | scenePressPosition() const |
| void | setAccepted(bool accepted = true) |
| QEventPoint::State | state() const |
| qreal | timeHeld() const |
| ulong | timestamp() const |
| QPointingDeviceUniqueId | uniqueId() const |
| QVector2D | velocity() const |
| bool | operator!=(const QEventPoint &other) const |
| bool | operator==(const QEventPoint &other) const |
Подробное описание
Документация по типам членов
enum QEventPoint::Stateflags QEventPoint::States
Задаёт состояние этой точки события.
| Постоянная | Значение | Описание |
|---|---|---|
QEventPoint::Unknown |
Qt::TouchPointUnknownState |
Неизвестное состояние. |
QEventPoint::Stationary |
Qt::TouchPointStationary |
Точка события не сдвинулась. |
QEventPoint::Pressed |
Qt::TouchPointPressed |
Точка касания или кнопка нажата. |
QEventPoint::Updated |
Qt::TouchPointMoved |
Точка события была обновлена. |
QEventPoint::Released |
Qt::TouchPointReleased |
Точка касания или кнопка была отпущена. |
Тип States — это псевдоним для QFlags<State>. Он хранит логическое ИЛИ сочетание значений State.
Документация свойств
accepted : bool
Это свойство содержит состояние принятия точки события.
В приложениях на основе виджетов это свойство не используется, так как для виджета имеет смысл только принимать или отклонять целое событие QInputEvent.
Однако в Qt Quick для элемента Item или обработчика событий нормально принимать только отдельные точки в QTouchEvent, которые фактически участвуют в жесте, в то время как другие точки могут быть переданы другим элементам или обработчикам. Ради согласованности это относится к любому QPointerEvent; и передача выполняется только тогда, когда все точки в QPointerEvent были приняты.
Функции доступа:
| bool | isAccepted() const |
| void | setAccepted(bool accepted = true) |
См. также QEvent::accepted.
[read-only] device : QPointingDevice* const
Это свойство содержит указательное устройство, из которого происходит эта точка события.
Функции доступа:
| const QPointingDevice * | device() const |
[read-only] ellipseDiameters : const QSizeF
Это свойство содержит ширину и высоту ограничивающей эллиптической области точки касания.
Возвращаемое значение в логических пикселях. Большинство сенсорных экранов не обнаруживают форму точки контакта, и никакие мыши или планшетные устройства не могут её обнаружить, поэтому нулевой размер является наиболее распространенным значением. На некоторых сенсорных экранах диаметры могут быть ненулевыми и всегда равными (эллипс аппроксимируется как окружность).
Функции доступа:
| QSizeF | ellipseDiameters() const |
[read-only] globalGrabPosition : const QPointF
Это свойство содержит глобальные координаты, в которых была захвачена эта точка.
Глобальные координаты относительны к экрану или виртуальному рабочему столу.
Функции доступа:
| QPointF | globalGrabPosition() const |
См. также globalPosition, grabPosition и sceneGrabPosition.
[read-only] globalLastPosition : const QPointF
Это свойство содержит глобальные координаты этой точки из предыдущего события нажатия или перемещения.
Глобальные координаты относительны к экрану или виртуальному рабочему столу.
Функции доступа:
| QPointF | globalLastPosition() const |
См. также globalPosition, lastPosition и sceneLastPosition.
[read-only] globalPosition : const QPointF
Это свойство содержит глобальные координаты этой точки.
Глобальные координаты относительны к экрану или виртуальному рабочему столу.
Функции доступа:
| QPointF | globalPosition() const |
См. также globalPressPosition, position и scenePosition.
[read-only] globalPressPosition : const QPointF
Это свойство содержит глобальные координаты, в которых эта точка была нажата.
Глобальные координаты относительны к экрану или виртуальному рабочему столу.
Функции доступа:
| QPointF | globalPressPosition() const |
См. также globalPosition, pressPosition и scenePressPosition.
[read-only] grabPosition : const QPointF
Это свойство содержит координаты, в которых была захвачена эта точка.
Координаты относительны к виджету или элементу, который получил событие.
Функции доступа:
| QPointF | grabPosition() const |
См. также position.
[read-only] id : const int
Это свойство содержит идентификатор этой точки события.
Примечание: Не предполагайте, что идентификаторы начинаются с нуля или что они последовательные. Такое предположение часто ложно из-за способа работы базовых драйверов.
Функции доступа:
| int | id() const |
[read-only] lastPosition : const QPointF
Это свойство содержит координаты этой точки из предыдущего события нажатия или перемещения.
Координаты относительны к виджету или элементу, который получил событие.
Функции доступа:
| QPointF | lastPosition() const |
См. также position и pressPosition.
[read-only] lastTimestamp : const ulong
Это свойство содержит время с предыдущего события QPointerEvent, содержащего эту точку.
Функции доступа:
| ulong | lastTimestamp() const |
См. также globalLastPosition.
[read-only] position : const QPointF
Это свойство содержит координаты этой точки.
Координаты относительны к виджету или элементу, который получил событие.
Функции доступа:
| QPointF | position() const |
[read-only] pressPosition : const QPointF
Это свойство содержит координаты, в которых была нажата эта точка.
Координаты относительны к виджету или элементу, который получил событие.
Функции доступа:
| QPointF | pressPosition() const |
См. также position.
[read-only] pressTimestamp : const ulong
Это свойство содержит последнее время нажатия этой точки.
Функции доступа:
| ulong | pressTimestamp() const |
См. также timestamp.
[read-only] pressure : const qreal
Это свойство содержит давление этой точки.
Возвращаемое значение в диапазоне 0.0 до 1.0.
Функции доступа:
| qreal | pressure() const |
[read-only] rotation : const qreal
Это свойство содержит угловую ориентацию этой точки.
Возвращаемое значение в градусах, где ноль (по умолчанию) означает, что палец, маркер или стилус направлен вверх, отрицательный угол означает, что он повернут влево, а положительный угол означает, что он повернут вправо. Большинство сенсорных экранов не обнаруживают поворот, поэтому ноль — самое распространённое значение.
Функции доступа:
| qreal | rotation() const |
[read-only] sceneGrabPosition : const QPointF
Это свойство содержит координаты сцены, в которых была захвачена эта точка.
Положение сцены — это положение относительно QQuickWindow, если оно обрабатывается в QQuickItem::event(), в координатах QGraphicsScene, если оно обрабатывается заменой QGraphicsItem::touchEvent(), или положение окна в приложениях с виджетами.
Функции доступа:
| QPointF | sceneGrabPosition() const |
См. также scenePosition, grabPosition и globalGrabPosition.
[read-only] sceneLastPosition : const QPointF
Это свойство содержит положение точки в сцене из предыдущего события нажатия или перемещения.
Положение сцены — это положение относительно QQuickWindow, если оно обрабатывается в QQuickItem::event(), в координатах QGraphicsScene, если оно обрабатывается заменой QGraphicsItem::touchEvent(), или положение окна в приложениях с виджетами.
Функции доступа:
| QPointF | sceneLastPosition() const |
См. также scenePosition и scenePressPosition.
[read-only] scenePosition : const QPointF
Это свойство содержит положение точки в сцене.
Положение сцены — это положение относительно QQuickWindow, если оно обрабатывается в QQuickItem::event(), в координатах QGraphicsScene, если оно обрабатывается заменой QGraphicsItem::touchEvent(), или положение окна в приложениях с виджетами.
Функции доступа:
| QPointF | scenePosition() const |
См. также scenePressPosition, position и globalPosition.
[read-only] scenePressPosition : const QPointF
Это свойство содержит положение точки в сцене при нажатии.
Положение сцены — это положение относительно QQuickWindow, если оно обрабатывается в QQuickItem::event(), в координатах QGraphicsScene, если оно обрабатывается заменой QGraphicsItem::touchEvent(), или положение окна в приложениях с виджетами.
Функции доступа:
| QPointF | scenePressPosition() const |
См. также scenePosition, pressPosition и globalPressPosition.
[read-only] state : const State
Это свойство содержит текущее состояние точки события.
Функции доступа:
| QEventPoint::State | state() const |
[read-only] timeHeld : const qreal
Это свойство содержит длительность, в миллисекундах, с момента нажатия и до момента отпуска этой точки.
Функции доступа:
| qreal | timeHeld() const |
См. также pressTimestamp и timestamp.
[read-only] timestamp : const ulong
Это свойство содержит последнее время, когда эта точка была включена в QPointerEvent.
Функции доступа:
| ulong | timestamp() const |
См. также QPointerEvent::timestamp().
[read-only] uniqueId : const QPointingDeviceUniqueId
Это свойство содержит уникальный идентификатор этой точки или маркера, если таковой имеется.
Часто он недопустим (см. isValid()), так как сенсорные экраны не могут уникально идентифицировать пальцы.
Если он получен из QTabletEvent, он идентифицирует серийный номер используемого стилуса.
Он может идентифицировать определённый маркер (фидуциальный объект), если используется драйвер TUIO с сенсорным экраном, поддерживающим их.
Функции доступа:
| QPointingDeviceUniqueId | uniqueId() const |
[read-only] velocity : const QVector2D
Это свойство содержит вектор скорости, в пикселях в секунду, в системе координат экрана или рабочего стола.
Примечание: Если возможности устройства включают QInputDevice::Velocity, это означает, что скорость получена от операционной системы (возможно, сенсорное оборудование или драйвер её предоставляют). Но обычно возможность Velocity не установлена, что указывает на то, что скорость рассчитывается Qt, используя простой фильтр Калмана для предоставления сглаженной средней скорости, а не мгновенного значения. По сути, он показывает, насколько быстро и в каком направлении пользователь перетаскивал эту точку в последних нескольких событиях, при этом последнее событие имеет наибольшее влияние.
Функции доступа:
| QVector2D | velocity() const |
См. также QInputDevice::capabilities() и QInputEvent::device().
Документация по функциям-членам
QEventPoint::QEventPoint(QEventPoint &&other)
Конструирует точку события, перемещая other.
QEventPoint::QEventPoint(const QEventPoint &other)
Конструирует точку события, создавая поверхностную копию other.
QEventPoint::QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition)
Конструирует точку события с заданными pointId, state, scenePosition и globalPosition.
QEventPoint &QEventPoint::operator=(QEventPoint &&other)
Перемещающее присваивание other текущей точке события.
QEventPoint &QEventPoint::operator=(const QEventPoint &other)
Присваивает other текущей точке события и возвращает ссылку на эту точку события.
QEventPoint::~QEventPoint()
Удаляет точку события.
QPointF QEventPoint::normalizedPosition() const
Возвращает нормализованное положение этой точки.
Координаты вычисляются путем преобразования globalPosition() в пространство QInputDevice::availableVirtualGeometry(), т.е. (0, 0) — это верхний левый угол, а (1, 1) — нижний правый угол.
См. также globalPosition.
bool QEventPoint::operator!=(const QEventPoint &other) const
Возвращает true, если эта точка события не равна other, в противном случае возвращает false.
bool QEventPoint::operator==(const QEventPoint &other) const
Возвращает true, если эта точка события равна other, в противном случае возвращает false.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qeventpoint.html