Класс 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, получившего событие.
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, получившего событие.
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