Тип 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.