Тип QML EventTouchPoint

Предоставляет информацию об отдельной точке касания в PointerEvent. Подробнее...

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

Свойства

• ellipseDiameters : size
• pressure : qreal
• rotation : qreal
• uniqueId : QPointerUniqueId

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

См. также PointerEvent и PointerHandler.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если вам необходимо идентифицировать конкретные объекты, ваше приложение должно предоставить пользовательский интерфейс для регистрации объектов и сопоставления их с функциональностью: позвольте пользователю выбрать значение, виртуальный инструмент или действие, попросите пользователя приблизить объект и сохраните сопоставление между uniqueId и его назначением, например, в Settings.