Spec-Zone.ru › Qt 5.6

Класс TouchPoint

(QTouchEvent::TouchPoint)

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

Заголовок: #include <TouchPoint>
qmake: QT += gui
С момента: Qt 4.6
  • Список всех членов, включая унаследованные

Типы

перечисление InfoFlag { Pen }
флаги InfoFlags

Публичные функции

TouchPoint(TouchPoint &&other)
InfoFlags flags() const
int id() const
QPointF lastNormalizedPos() const
QPointF lastPos() const
QPointF lastScenePos() const
QPointF lastScreenPos() const
QPointF normalizedPos() const
QPointF pos() const
qreal pressure() const
QVector<QPointF> rawScreenPositions() const
QRectF rect() const
QPointF scenePos() const
QRectF sceneRect() const
QPointF screenPos() const
QRectF screenRect() const
QPointF startNormalizedPos() const
QPointF startPos() const
QPointF startScenePos() const
QPointF startScreenPos() const
Qt::TouchPointState state() const
QVector2D velocity() const

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

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

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

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

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

Постоянная Значение Описание
QTouchEvent::TouchPoint::Pen 0x0001 Указывает, что контакт был выполнен выделенным указательным устройством (например, ручкой), а не пальцем.

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

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

TouchPoint::TouchPoint(TouchPoint &&other)

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

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.

END_OF_DOCUMENT_MARKER

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

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

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

QRectF TouchPoint::rect() const

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

Примечание: Эта функция возвращает пустой прямоугольник, если устройство не сообщает о размерах точки касания.

QPointF TouchPoint::scenePos() const

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

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

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

QRectF TouchPoint::sceneRect() const

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

Примечание: Эта функция возвращает пустой прямоугольник, если устройство не сообщает о размерах точки касания.

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

QPointF TouchPoint::screenPos() const

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

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

QRectF TouchPoint::screenRect() const

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

Примечание: Эта функция возвращает пустой прямоугольник, если устройство не сообщает о размерах точки касания.

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

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

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

QVector2D TouchPoint::velocity() const

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

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

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

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qtouchevent-touchpoint.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API