Тип QML EventTouchPoint

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

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

Свойства

• ellipseDiameters : размер
• pressure : qreal
• rotation : qreal
• uniqueId : QPointerUniqueId

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

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

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

[только для чтения] ellipseDiameters : размер

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

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

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

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

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

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

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

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

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

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

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

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

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