ObjectPicker QML Type
La clase ObjectPicker crea una instancia de un componente que permite interactuar con una entidad mediante un proceso denominado «selección». Más información...
| Import Statement: | import Qt3D.Render 2.12 |
| In C++: | QObjectPicker |
| Status: | Deprecated |
Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- containsMouse : bool
- dragEnabled : bool
- hoverEnabled : bool
- pressed : bool
- priority : int
Señales
- clicked(PickEvent pick)
- entered()
- exited()
- moved(PickEvent pick)
- pressed(PickEvent pick)
- released(PickEvent pick)
Descripción detallada
Para cada combinación de ventana de visualización y cámara, la selección lanza un rayo a través de la escena para encontrar entidades cuyo volumen delimitador se cruce con el rayo. El volumen delimitador se calcula utilizando los valores del búfer de atributos especificado por el atributo `boundingVolumePositionAttribute` de la geometría.
Las señales pressed(), released(), clicked(), moved(), entered() y exited() se emiten cuando el volumen delimitador definido por la propiedad pickAttribute se cruza con un rayo.
La mayoría de las señales transportan una instancia de ` PickEvent `. Si ` PickingSettings.pickMode` está establecido en ` PickingSettings.TrianglePicking`, el tipo real del parámetro de selección será ` PickTriangleEvent`.
Las consultas de selección se realizan al pulsar y al soltar el botón del ratón. Si el arrastre está habilitado, las consultas también se producen con cada movimiento del ratón mientras se mantiene pulsado cualquier botón. Si el paso del cursor está habilitado, las consultas se producen con cada movimiento del ratón, incluso si no se pulsa ningún botón.
Nota: Para recibir eventos de paso del cursor en QtQuick, también debe configurarse la propiedad hoverEnabled de Scene3D.
Nota: Las instancias de este componente no deben compartirse; si no se respeta esta condición, es muy probable que se produzca un comportamiento indefinido.
Nota: El valor del plano lejano de la cámara afecta a la selección y produce resultados incorrectos debido a la precisión de los números de coma flotante si es superior a ~100 000.
Véase también PickingSettings, Geometry, Attribute, PickEvent, PickTriangleEvent y NoPicking.
Documentación de la propiedad
containsMouse : bool [read-only]
Indica si el selector de objetos contiene actualmente el ratón
dragEnabled : bool
hoverEnabled : bool
Especifica si está activada la función de desplazamiento del cursor
pressed : bool [read-only]
Indica si el selector de objetos está pulsado en este momento
priority : int
La prioridad que se utilizará al filtrar los resultados de la preparación de pedidos por prioridad cuando PickingSettings.pickResultMode esté establecido en PickingSettings.PriorityPick.
Documentación de Signal
clicked(PickEvent pick)
Esta señal se emite cuando el volumen delimitador definido por la propiedad «pickAttribute» se cruza con un rayo al hacer clic con el ratón. Se puede acceder a la información sobre la intersección a través del parámetro « pick ».
Nota: El controlador correspondiente es ` onClicked`.
entered()
Esta señal se emite cuando el volumen delimitador definido por la propiedad «pickAttribute» se cruza con un rayo del ratón que entra en dicho volumen.
Nota: El controlador correspondiente es onEntered.
exited()
Esta señal se emite cuando el volumen delimitador definido por la propiedad `pickAttribute` se cruza con un rayo que sale del volumen.
Nota: El controlador correspondiente es onExited.
moved(PickEvent pick)
Esta señal se emite cuando el volumen delimitador definido por la propiedad «pickAttribute» se cruza con un rayo al mover el ratón con un botón pulsado. Se puede acceder a la información sobre la intersección a través del parámetro « pick ».
Nota: El controlador correspondiente es ` onMoved`.
pressed(PickEvent pick)
Esta señal se emite cuando el volumen delimitador definido por la propiedad «pickAttribute» se cruza con un rayo al pulsar el botón del ratón. Se puede acceder a la información sobre la intersección a través del parámetro « pick ».
Nota: El controlador correspondiente es ` onPressed`.
released(PickEvent pick)
Esta señal se emite cuando el volumen delimitador definido por la propiedad «pickAttribute» se cruza con un rayo al soltar el botón del ratón. Se puede acceder a la información sobre la intersección a través del parámetro « pick ».
Nota: El controlador correspondiente es ` onReleased`.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.