Тип QML HandlerPoint

Точка события. Подробнее...

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

Свойства

• ellipseDiameters : размер
• id : int
• modifiers : перечисление
• position : QPointF
• pressPosition : QPointF
• pressedButtons : перечисление
• pressure : qreal
• rotation : qreal
• sceneGrabPosition : QPointF
• scenePosition : QPointF
• scenePressPosition : QPointF
• uniqueId : PointingDeviceUniqueId
• velocity : QVector2D

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

Представление QML объекта QQuickEventPoint.

Возможна привязка к свойствам текущей точки обработчика SinglePointHandler. Например:

import QtQuick 2.12

Item {
    width: 640
    height: 480

    DragHandler {
        id: handler
        target: null
    }

    Text {
        color: handler.active ? "darkgreen" : "black"
        text: handler.centroid.position.x.toFixed(1) + "," + handler.centroid.position.y.toFixed(1)
        x: handler.centroid.position.x - width / 2
        y: handler.centroid.position.y - height
    }
}

Точка обновляется, когда обработчик DragHandler активно реагирует на EventPoint; но при отпускании точки или при обработке текущей точки другим обработчиком, position.x и position.y равны 0.

Примечание: Практически идентично QtQuick::EventPoint; однако EventPoint — это долгоживущий объект QObject, который становится недействительным между жестами и повторно используется для последующей доставки событий. Непрерывные привязки к его свойствам невозможны, и отдельный обработчик не может полагаться на него за пределами периода, когда эта точка является частью активного жеста, который обрабатывает этот обработчик. HandlerPoint — это Q_GADGET, который принадлежит обработчику. Это позволяет устанавливать привязки к его свойствам на срок действия.

См. также SinglePointHandler::point.

Документация по свойствам

[только для чтения] ellipseDiameters : size

Это свойство содержит диаметры контактной области, если событие происходит от точки касания и устройство предоставляет эту информацию.

Точка касания моделируется как эллиптическая область, где палец прижат к сенсорному экрану. (На самом деле, это также может быть представлено как растровое изображение; но в этом случае ожидается, что эллиптическое приближение будет подогнано к контактной области перед отправкой события). Чем сильнее пользователь нажимает, тем больше контактная область; поэтому эти диаметры предоставляют альтернативный способ определения давления, если устройство не включает отдельный сенсор давления. Эллипс центрирован на scenePosition (position в локальных координатах элемента PointerHandler). Свойство rotation предоставляет угол поворота эллипса, если он известен. Ожидается, что если rotation равен нулю, высота является большей размерностью (большой осью) из-за обычного положения руки, направленной вверх или наружу по поверхности.

Если контактная область неизвестна или устройство не является сенсорным экраном, эти значения будут нулевыми.

См. также QtQuick::EventTouchPoint::ellipseDiameters, QtQuick::TouchPoint::ellipseDiameters и QTouchEvent::TouchPoint::ellipseDiameters.

[только для чтения] id : int

Номер идентификатора точки

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

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

См. также QTouchEvent::TouchPoint::id.

[только для чтения] modifiers : перечисление

Какие клавиши модификаторов нажаты в данный момент

Это свойство содержит нажатые клавиши модификаторов клавиатуры в момент возникновения события.

[только для чтения] position : QPointF

Позиция внутри parent элемента

Это положение точки события относительно границ родительского элемента.

[только для чтения] pressPosition : QPointF

Позиция нажатия внутри parent элемента

Это положение, в котором была нажата эта точка, относительно границ родительского элемента.

[только для чтения] pressedButtons : перечисление

Какие кнопки мыши или стилуса нажаты в данный момент

См. также MouseArea::pressedButtons.

[только для чтения] pressure : qreal

Это свойство показывает, насколько сильно пользователь нажимает на стилус на графическом планшете или палец на сенсорном экране в диапазоне от 0 (нет измеряемого давления) до 1.0 (максимальное давление, которое может измерить устройство).

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

[только для чтения] rotation : qreal

Это свойство содержит угол поворота стилуса на графическом планшете или угол поворота контактной области точки касания на сенсорном экране.

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

[только для чтения] sceneGrabPosition : QPointF

Позиция захвата в сцене

Если эта точка была захвачена обработчиком указателя или элементом, это означает, что этот объект взял на себя полную ответственность за обработку перемещения и отпускания этой точки. В этом случае это положение, в котором произошел захват, в системе координат дерева сцены.

[только для чтения] scenePosition : QPointF

Положение в сцене

Это положение точки события относительно границ сцены Qt Quick (обычно всего окна).

[только для чтения] scenePressPosition : QPointF

Положение нажатия в сцене

Это положение, в котором была нажата эта точка, в системе координат дерева сцены.

[только для чтения] uniqueId : PointingDeviceUniqueId

Уникальный идентификатор точки, если он есть

Обычно пусто, поскольку сенсорные экраны не могут уникально идентифицировать пальцы.

На некоторых типах сенсорных экранов, особенно тех, которые используют драйверы TUIO, возможно использование распознаваемых физических маркеров (маркеров) в дополнение к пальцам. Поэтому, если эта точка является точкой касания и uniqueId установлено, это идентификатор такого объекта.

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

Для интерпретации содержимого этого идентификатора требуется знание используемого оборудования и драйверов.

См. также QTabletEvent::uniqueId, QtQuick::TouchPoint::uniqueId и QtQuick::EventTouchPoint::uniqueId.

[только для чтения] velocity : QVector2D

Вектор, представляющий среднюю скорость и направление движения

Это вектор скорости, направленный в направлении движения, в логических пикселях в секунду. Он имеет компоненты x и y, по крайней мере один из которых будет отличным от нуля, когда эта точка находится в движении. Он содержит среднюю последнюю скорость: насколько быстро и в каком направлении точка события перемещалась в последнее время.

См. также QtQuick::EventPoint::velocity, QtQuick::TouchPoint::velocity и QTouchEvent::TouchPoint::velocity.