Класс TouchPoint

Класс TouchPoint предоставляет информацию о точке касания в событии QTouchEvent. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Типы публичного доступа

Функции публичного доступа

Подробное описание

Класс TouchPoint предоставляет информацию о точке касания в событии QTouchEvent.

Документация по типам членов

перечисление TouchPoint::InfoFlagфлаги TouchPoint::InfoFlags

Значения этого перечисления описывают дополнительную информацию о точке касания.

Тип InfoFlags является типом-синонимом для QFlags<InfoFlag>. Он хранит логическое ИЛИ сочетание значений InfoFlag.

Документация по функциям-членам

TouchPoint::TouchPoint(TouchPoint &&other)

Перемещающая конструкция экземпляра TouchPoint, позволяющая ему указывать на тот же объект, на который указывал other.

QSizeF TouchPoint::ellipseDiameters() const

Возвращает ширину и высоту ограничивающего эллипса этой точки касания. Значение возврата — в логических пикселях. Большинство сенсорных экранов не определяют форму точки контакта, поэтому наиболее распространённое значение — нулевой размер. В других случаях диаметры могут быть ненулевыми и равными (эллипс аппроксимируется окружностью).

Эта функция была представлена в Qt 5.9.

TouchPoint::InfoFlags TouchPoint::flags() const

Возвращает дополнительную информацию о точке касания.

См. также QTouchEvent::TouchPoint::InfoFlags.

int TouchPoint::id() const

Возвращает номер id этой точки касания.

Не предполагайте, что номера id начинаются с нуля или что они являются последовательными. Такое предположение часто ложно из-за способа работы драйверов.

QPointF TouchPoint::lastNormalizedPos() const

Возвращает нормированное положение этой точки касания из предыдущего события касания.

Координаты нормализованы относительно размера сенсорного устройства, т. е. (0,0) — верхний левый угол, а (1,1) — нижний правый угол.

См. также normalizedPos() и startNormalizedPos().

QPointF TouchPoint::lastPos() const

Возвращает положение этой точки касания из предыдущего события касания относительно виджета или QGraphicsItem, получившего событие.

См. также pos() и startPos().

QPointF TouchPoint::lastScenePos() const

Возвращает положение в пространстве сцены этой точки касания из предыдущего события касания.

Положение в пространстве сцены — это положение в координатах QGraphicsScene, если событие QTouchEvent обрабатывается переопределением QGraphicsItem::touchEvent(), и идентично положению на экране для виджетов.

См. также scenePos() и startScenePos().

QPointF TouchPoint::lastScreenPos() const

Возвращает положение на экране этой точки касания из предыдущего события касания.

См. также screenPos() и startScreenPos().

QPointF TouchPoint::normalizedPos() const

Возвращает нормированное положение этой точки касания.

Координаты нормализованы относительно размера сенсорного устройства, т. е. (0,0) — верхний левый угол, а (1,1) — нижний правый угол.

См. также startNormalizedPos(), lastNormalizedPos() и pos().

QPointF TouchPoint::pos() const

Возвращает положение этой точки касания относительно виджета или QGraphicsItem, получившего событие.

См. также startPos(), lastPos(), screenPos(), scenePos() и normalizedPos().

qreal TouchPoint::pressure() const

Возвращает давление этой точки касания. Значение возвращается в диапазоне от 0,0 до 1,0.

QVector<QPointF> TouchPoint::rawScreenPositions() const

Возвращает исходные, неотфильтрованные координаты точки касания. Координаты указаны в координатах родного экрана. Для получения локальных координат можно использовать mapFromGlobal() объекта QWindow, возвращаемого QTouchEvent::window().

Примечание: Возвращает пустой вектор, если возможности устройства ввода касания не включают QTouchDevice::RawPositions.

Примечание: Координаты родного экрана относятся к родному ориентации экрана, который в случае мобильных устройств, обычно, портретный. Это означает, что в системах, способных изменять ориентацию экрана, координаты в этом списке не будут отражать текущую ориентацию (в отличие от pos(), screenPos() и т.д.) и всегда будут сообщаться в родной ориентации.

Функция была введена в Qt 5.0.

См. также QTouchDevice::capabilities(), device() и window().

qreal TouchPoint::rotation() const

Возвращает угловую ориентацию этой точки касания. Возвращаемое значение выражается в градусах, где ноль (значение по умолчанию) указывает, что палец или маркер направлен вверх, отрицательный угол означает поворот влево, а положительный угол означает поворот вправо. Большинство сенсорных экранов не распознают поворот, поэтому наиболее распространенное значение равно нулю.

Функция была введена в Qt 5.8.

QPointF TouchPoint::scenePos() const

Возвращает сцену координаты этой точки касания.

Координаты сцены — это координаты в QGraphicsScene, если событие QTouchEvent обрабатывается с помощью переопределения QGraphicsItem::touchEvent(), и идентичны координатам экрана для виджетов.

См. также startScenePos(), lastScenePos() и pos().

QPointF TouchPoint::screenPos() const

Возвращает координаты точки касания на экране.

См. также startScreenPos(), lastScreenPos() и pos().

QPointF TouchPoint::startNormalizedPos() const

Возвращает нормализованные начальные координаты этой точки касания.

Координаты нормализованы относительно размера устройства ввода касания, т.е. (0,0) — это верхний левый угол, а (1,1) — нижний правый угол.

См. также normalizedPos() и lastNormalizedPos().

QPointF TouchPoint::startPos() const

Возвращает начальные координаты этой точки касания, относительные к виджету или QGraphicsItem, получившему событие.

См. также pos() и lastPos().

QPointF TouchPoint::startScenePos() const

Возвращает начальные координаты сцены этой точки касания.

Координаты сцены — это координаты в QGraphicsScene, если событие QTouchEvent обрабатывается с помощью переопределения QGraphicsItem::touchEvent(), и идентичны координатам экрана для виджетов.

См. также scenePos() и lastScenePos().

QPointF TouchPoint::startScreenPos() const

Возвращает начальные координаты точки касания на экране.

См. также screenPos() и lastScreenPos().

Qt::TouchPointState TouchPoint::state() const

Возвращает текущее состояние этой точки касания.

QPointingDeviceUniqueId TouchPoint::uniqueId() const

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

Обычно он недействителен (см. isValid()), потому что сенсорные экраны не могут уникально идентифицировать пальцы. Но когда установлен флаг Token, ожидается, что он будет уникально идентифицировать конкретный маркер (фидуциальный объект).

Функция была введена в Qt 5.8.

См. также flags.

QVector2D TouchPoint::velocity() const

Возвращает вектор скорости для этой точки касания. Вектор указан в системе координат экрана, используя пиксели в секунду для величины.

Примечание: Возвращаемый вектор действителен только в том случае, если возможности устройства ввода касания включают QTouchDevice::Velocity.

См. также QTouchDevice::capabilities() и device().