En esta página

Qt3DRender::QObjectPicker Class

class Qt3DRender::QObjectPicker

La 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.