Тип QML ObjectPicker

Класс ObjectPicker создает компонент, который может использоваться для взаимодействия с сущностью посредством процесса, известного как выбор. Подробнее...

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

Свойства

• containsMouse : bool
• dragEnabled : bool
• hoverEnabled : bool
• pressed : bool
• priority : int

Сигналы

• clicked(PickEvent pick)
• clicked(PickEvent pick)
• entered()
• exited()
• moved(PickEvent pick)
• pressed(PickEvent pick)
• released(PickEvent pick)

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

Для каждой комбинации области просмотра и камеры выбор выполняет поиск луча в сцене, чтобы найти сущности, чьи граничные объемы пересекаются с лучом. Граничный объем вычисляется с использованием значений в буфере атрибутов, указанном в boundingVolumePositionAttribute геометрии.

Сигналы pressed(), released(), clicked(), moved(), entered() и exited() излучаются, когда граничный объем, определенный свойством pickAttribute, пересекается с лучом.

Большинство сигналов несут экземпляр PickEvent. Если PickingSettings.pickMode установлен в PickingSettings.TrianglePicking, фактический тип параметра pick будет PickTriangleEvent.

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

Примечание: Чтобы получать события наведения в QtQuick, свойство hoverEnabled объекта Scene3D также должно быть установлено.

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

Примечание: Значение дальнего плоскости камеры влияет на выбор и приводит к неверным результатам из-за точности с плавающей точкой, если оно больше ~100 000.

См. также PickingSettings, Geometry, Attribute, PickEvent, PickTriangleEvent и NoPicking.

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

containsMouse : bool

Указывает, содержит ли объект пикер в данный момент мышь

dragEnabled : bool

hoverEnabled : bool

Указывает, включено ли наведение

pressed : bool

Указывает, нажат ли объект пикер в данный момент

priority : int

Приоритет, который будет использоваться при фильтрации результатов выбора по приоритету, когда PickingSettings.pickResultMode установлен в PickingSettings.PriorityPick.

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

clicked(PickEvent pick)

Этот сигнал излучается, когда граничный объем, определяемый свойством pickAttribute, пересекается с лучом при нажатии мыши. Информация о пересечении доступна через параметр pick.

Примечание: Соответствующий обработчик — onClicked.

clicked(PickEvent pick)

Этот сигнал излучается, когда граничный объем, определенный свойством pickAttribute, пересекается с лучом при нажатии мыши. Объект PickEvent pick содержит подробности события.

Примечание: Соответствующий обработчик — onClicked.

entered()

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

Примечание: Соответствующий обработчик — onEntered.

exited()

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

Примечание: Соответствующий обработчик — onExited.

moved(PickEvent pick)

Этот сигнал излучается, когда граничный объем, определяемый свойством pickAttribute, пересекается с лучом при перемещении мыши с нажатой кнопкой. Информация о пересечении доступна через параметр pick.

Примечание: Соответствующий обработчик — onMoved.

pressed(PickEvent pick)

Этот сигнал излучается, когда граничный объем, определяемый свойством pickAttribute, пересекается с лучом при нажатии мыши. Информация о пересечении доступна через параметр pick.

Примечание: Соответствующий обработчик — onPressed.

released(PickEvent pick)

Этот сигнал излучается, когда граничный объем, определяемый свойством pickAttribute, пересекается с лучом при отпускании мыши. Информация о пересечении доступна через параметр pick.

Примечание: Соответствующий обработчик — onReleased.