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