Класс 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
Это свойство содержит номер идентификатора этой точки события.
Примечание: Не предполагайте, что номера ID начинаются с нуля или что они последовательны. Такое предположение часто ложно из-за того, как работают подлежащие драйверы.
Функции доступа:
| 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.0/qeventpoint.html