Spec-Zone.ru › Qt

Класс 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

Свойства

  • accepted : bool
  • device : QPointingDevice* const
  • ellipseDiameters : const QSizeF
  • globalGrabPosition : const QPointF
  • globalLastPosition : const QPointF
  • globalPosition : const QPointF
  • globalPressPosition : const QPointF
  • grabPosition : const QPointF
  • id : const int
  • lastPosition : const QPointF
  • lastTimestamp : const ulong
  • position : const QPointF
  • pressPosition : const QPointF
  • pressTimestamp : const ulong
  • pressure : const qreal
  • rotation : const qreal
  • sceneGrabPosition : const QPointF
  • sceneLastPosition : const QPointF
  • scenePosition : const QPointF
  • scenePressPosition : const QPointF
  • state : const State
  • timeHeld : const qreal
  • timestamp : const ulong
  • uniqueId : const QPointingDeviceUniqueId
  • velocity : const QVector2D

Открытые функции

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, однако, для элемента или обработчика событий нормально принять только отдельные точки в 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

Это свойство содержит уникальный идентификатор этой точки или маркера, если таковой имеется.

Часто имеет значение invalid (см. 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.2/qeventpoint.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API