Класс TouchPoint

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

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

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

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

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

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

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

enum 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

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

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

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, ожидается, что он однозначно идентифицирует конкретный маркер (фiducial объект).

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

См. также flags.

QVector2D TouchPoint::velocity() const

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

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

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