Тип QML PointerHandler

Абстрактный обработчик событий указателя. Подробнее...

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

Свойства

• active : bool
• enabled : bool
• grabPermissions : flags
• margin : real
• parent : Item
• target : Item

Сигналы

• canceled(EventPoint point)
• grabChanged(GrabTransition transition, EventPoint point)

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

PointerHandler — базовый класс обработчика ввода (не зарегистрирован как тип QML) для событий от любого устройства указания (тачскрин, мышь или графический планшет).

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

[только для чтения] active : bool

Принимает значение true, когда этот обработчик ввода взял на себя полную ответственность за обработку одного или нескольких EventPoint, успешно захватив их эксклюзивный захват. Это означает, что он сохраняет актуальность своих свойств в соответствии с перемещениями этих точек события и активно манипулирует своим target (если таковой имеется).

enabled : bool

Если PointerHandler отключён, он отклонит все события, и сигналы не будут выпущены.

grabPermissions : flags

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

По умолчанию PointerHandler.CanTakeOverFromItems | PointerHandler.CanTakeOverFromHandlersOfDifferentType | PointerHandler.ApprovesTakeOverByAnything, что разрешает большинство сценариев захвата, но предотвращает, например, конфликт двух PinchHandler за те же точки касания.

margin : real

Отступ за пределами границ элемента parent, в пределах которого точка события может активировать этот обработчик. Например, в PinchHandler, где target также является parent, полезно установить это значение на расстояние, по крайней мере, вдвое превышающее ширину типичного пальца пользователя, чтобы если parent был масштабирован до очень малого размера, жесты pinch всё ещё были возможны. Или, если кнопка на основе TapHandler расположена рядом с краем экрана, она может использоваться для соответствия закону Фиттса: реагировать на щелчки мыши на краю экрана, даже если кнопка визуально удалена от края на несколько пикселей.

Значение по умолчанию равно 0.

[только для чтения] parent : Item

Элемент Item, который является областью действия обработчика; элемент, в котором он был объявлен. Обработчик будет обрабатывать события от имени этого элемента, что означает, что событие указателя актуально, если по крайней мере одна из его точек события находится внутри внутреннего пространства элемента. Изначально target() идентичен, но может быть переназначен.

См. также target и QObject::parent().

target : Item

Элемент Item, которым будет манипулировать этот обработчик.

По умолчанию он совпадает с parent, элементом, в котором объявлен обработчик. Однако иногда может быть полезно установить целевой элемент на другой элемент, чтобы обрабатывать события внутри одного элемента, но манипулировать другим; или null, чтобы отключить стандартное поведение и сделать что-то другое вместо этого.

Документация по сигналам

canceled(EventPoint point)

Если этот обработчик уже захватил указанную точку point, этот сигнал выпускается, когда захват украден другим обработчиком указателя или элементом.

grabChanged(GrabTransition transition, EventPoint point)

Этот сигнал генерируется, когда захват изменяется каким-либо образом, относящимся к этому обработчику.

transition (глагол) показывает, что произошло. point (объект) — это точка, которая была захвачена или освобождена.