Qt3DRender::QObjectPicker Class
class Qt3DRender::QObjectPickerLa clase QObjectPicker crea una instancia de un componente que se puede utilizar para interactuar con una QEntity mediante un proceso conocido como «picking». Más información...
| Encabezado: | #include <qobjectpicker.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| En QML: | ObjectPicker |
| Heredado de: | Qt3DCore::QComponent |
| Estado: | Obsoleto |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
Propiedades
|
Funciones públicas
| bool | containsMouse() const |
| bool | isDragEnabled() const |
| bool | isHoverEnabled() const |
| bool | isPressed() const |
| int | priority() const |
Ranuras públicas
| void | setDragEnabled(bool dragEnabled) |
| void | setHoverEnabled(bool hoverEnabled) |
| void | setPriority(int priority) |
Señales
| void | clicked(Qt3DRender::QPickEvent *pick) |
| void | containsMouseChanged(bool containsMouse) |
| void | dragEnabledChanged(bool dragEnabled) |
| void | entered() |
| void | exited() |
| void | hoverEnabledChanged(bool hoverEnabled) |
| void | moved(Qt3DRender::QPickEvent *pick) |
| void | pressed(Qt3DRender::QPickEvent *pick) |
| void | pressedChanged(bool pressed) |
| void | priorityChanged(int priority) |
| void | released(Qt3DRender::QPickEvent *pick) |
Descripción detallada
Para cada combinación de ventana gráfica 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 ` QPickEvent `. Si `QPickingSettings::pickMode()` está establecido en ` QPickingSettings::TrianglePicking`, el tipo real del parámetro de selección será ` QPickTriangleEvent`.
Las consultas de selección se realizan al pulsar y al soltar el ratón. Si el arrastre está habilitado, las consultas también se producen con cada movimiento del ratón mientras se mantenga pulsado cualquier botón. Si el desplazamiento con el cursor está habilitado, las consultas se producen con cada movimiento del ratón, incluso si no se pulsa ningún botón.
Para consultas de ray casting generalizadas, consulta Qt3DRender::QRayCaster y Qt3DRender::QScreenRayCaster.
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 Qt3DRender::QPickingSettings, Qt3DCore::QGeometry, Qt3DCore::QAttribute, Qt3DRender::QPickEvent, Qt3DRender::QPickTriangleEvent y Qt3DRender::QNoPicking.
Documentación de la propiedad
[read-only] containsMouse : bool
Especifica si el selector de objetos contiene actualmente el ratón
Funciones de acceso:
| bool | containsMouse() const |
Señal de notificación:
| void | containsMouseChanged(bool containsMouse) |
dragEnabled : bool
Especifica si está habilitada la función de arrastrar
Funciones de acceso:
| bool | isDragEnabled() const |
| void | setDragEnabled(bool dragEnabled) |
Señal de notificación:
| void | dragEnabledChanged(bool dragEnabled) |
hoverEnabled : bool
Especifica si está activada la función «hover»
Funciones de acceso:
| bool | isHoverEnabled() const |
| void | setHoverEnabled(bool hoverEnabled) |
Señal de notificación:
| void | hoverEnabledChanged(bool hoverEnabled) |
[read-only] pressed : bool
Especifica si el selector de objetos está pulsado en este momento
Funciones de acceso:
| bool | isPressed() const |
Señal de notificación:
| void | pressedChanged(bool pressed) |
priority : int
La prioridad que se utilizará al filtrar los resultados de la selección por prioridad cuando la opción « QPickingSettings::pickResultMode » esté configurada en « QPickingSettings::NearestPriorityPick ».
Funciones de acceso:
| int | priority() const |
| void | setPriority(int priority) |
Señal de notificación:
| void | priorityChanged(int priority) |
Documentación de funciones de miembro
[signal] void QObjectPicker::clicked(Qt3DRender::QPickEvent *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; el objeto `QPickEvent` pick contiene los detalles del evento.
bool QObjectPicker::containsMouse() const
Devuelve «true» si el selector de objetos tiene actualmente el ratón sobre él
Nota: Funcióngetter para la propiedad containsMouse.
[signal] void QObjectPicker::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.
[signal] void QObjectPicker::exited()
Esta señal se emite cuando el volumen delimitador definido por la propiedad «pickAttribute» se cruza con un rayo que sale de dicho volumen.
bool QObjectPicker::isDragEnabled() const
Devuelve «true» si está habilitado el arrastre
Nota: Funcióngetter para la propiedad dragEnabled.
bool QObjectPicker::isHoverEnabled() const
Devuelve «true» si está habilitada la función de desplazamiento del cursor
Nota: Funcióngetter para la propiedad ` hoverEnabled`.
[signal] void QObjectPicker::moved(Qt3DRender::QPickEvent *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; el evento QPickEvent pick contiene los detalles del evento.
[signal] void QObjectPicker::pressed(Qt3DRender::QPickEvent *pick)
Esta señal se emite cuando el volumen delimitador definido por la propiedad «pickAttribute» se cruza con un rayo al pulsar el ratón; el objeto `QPickEvent` pick contiene los detalles del evento.
[signal] void QObjectPicker::released(Qt3DRender::QPickEvent *pick)
Esta señal se emite cuando el volumen delimitador definido por la propiedad «pickAttribute» se cruza con un rayo al soltar el ratón; el objeto « pick » de QPickEvent contiene los detalles del evento.
[slot] void QObjectPicker::setDragEnabled(bool dragEnabled)
Establece la propiedad « dragEnabled » en dragEnabled
Nota: Funciónde asignación para la propiedad dragEnabled.
Véase también isDragEnabled().
[slot] void QObjectPicker::setHoverEnabled(bool hoverEnabled)
Establece la propiedad « hoverEnabled » en hoverEnabled
Nota: Funciónde asignación para la propiedad hoverEnabled.
Véase también isHoverEnabled().
[slot] void QObjectPicker::setPriority(int priority)
Establece la prioridad del selector en « priority ». Esto se utiliza cuando el modo de resultados de preparación en QPickingSettings está configurado en « QPickingSettings::NearestPriorityPick ». Los resultados de preparación se ordenan por prioridad más alta y distancia de preparación más corta.
Nota: Funciónde asignación para la propiedad « priority ».
Véase también priority().
© 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.