Класс TouchPoint

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

Этот класс был введён в Qt 4.6.

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

Общедоступные типы

Общедоступные функции

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

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

перечисление 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().