Spec-Zone.ru › Qt 6.0

Класс 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 для элемента 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

Spec-Zone.ru

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