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

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

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

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().