Тип QML PointerHandler

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

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

Свойства

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

Сигналы

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

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

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

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

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

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

enabled : bool

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

grabPermissions : flags

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

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

margin : real

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

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

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

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

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

target : Item

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

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

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

canceled(point)

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

grabChanged(transition, EventPoint point)

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

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