En esta página

Qt Quick 3D - Ejemplo de selección

Muestra cómo seleccionar modelos.

Este ejemplo muestra cómo seleccionar modelos. Hay tres modelos animados diferentes que se pueden seleccionar. Cuando se selecciona un modelo, la animación se detiene y el color del modelo cambia para que quede claro cuál es el modelo seleccionado. La información detallada del resultado de la selección se muestra en la parte superior de la ventana de la aplicación.

Tres objetos con información de selección que muestran la posición del cubo seleccionado

Cómo hacer que un modelo sea seleccionable

Para que un modelo se pueda seleccionar, hay que establecer la propiedad « pickable » en « true ». También añadimos « objectName » para que el modelo pueda mostrar el nombre del modelo seleccionado.

Model {
    id: cubeModel
    objectName: "Cube"
    source: "#Cube"
    pickable: true
    property bool isPicked: false

La propiedad ` isPicked ` se añadió para poder activar o desactivar la animación y el color.

materials: PrincipledMaterial {
    baseColor: cubeModel.isPicked ? "#41cd52" : "#09102b"
    ...
SequentialAnimation on eulerRotation {
    running: !cubeModel.isPicked

Obtención de los resultados de la selección

Para realizar la selección propiamente dicha, debemos añadir un control ` MouseArea ` que cubra por completo el área ` View3D`.

MouseArea {
    anchors.fill: view

En el controlador onClicked del área del ratón, utilizamos el método pick para obtener el resultado real de la selección.

var result = view.pick(mouse.x, mouse.y);

Si el resultado contiene un ` target object`, analizamos los detalles del mismo y los mostramos en el campo de texto situado en la parte superior de la vista de la aplicación.

if (result.objectHit) {
    var pickedObject = result.objectHit;
    // Toggle the isPicked property for the model
    pickedObject.isPicked = !pickedObject.isPicked;
    // Get picked model name
    pickName.text = pickedObject.objectName;
    // Get other pick specifics
    uvPosition.text = "("
            + result.uvPosition.x.toFixed(2) + ", "
            + result.uvPosition.y.toFixed(2) + ")";
    distance.text = result.distance.toFixed(2);
    scenePosition.text = "("
            + result.scenePosition.x.toFixed(2) + ", "
            + result.scenePosition.y.toFixed(2) + ", "
            + result.scenePosition.z.toFixed(2) + ")";
    localPosition.text = "("
            + result.position.x.toFixed(2) + ", "
            + result.position.y.toFixed(2) + ", "
            + result.position.z.toFixed(2) + ")";
    worldNormal.text = "("
            + result.sceneNormal.x.toFixed(2) + ", "
            + result.sceneNormal.y.toFixed(2) + ", "
            + result.sceneNormal.z.toFixed(2) + ")";
    localNormal.text = "("
            + result.normal.x.toFixed(2) + ", "
            + result.normal.y.toFixed(2) + ", "
            + result.normal.z.toFixed(2) + ")";

Proyecto de ejemplo en @code.qt.io

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