En esta página

NodeInstantiator QML Type

Crea nodos de forma dinámica. Más...

Import Statement: import Qt3D.Core 2.12
Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Señales

Métodos

Descripción detallada

Un NodeInstantiator se puede utilizar para controlar la creación dinámica de nodos o para crear dinámicamente varios objetos a partir de una plantilla.

El elemento NodeInstantiator gestionará los objetos que cree. Dichos objetos están vinculados al Instantiator y también pueden ser eliminados por el NodeInstantiator si cambian las propiedades de este. Los nodos también pueden destruirse dinámicamente por otros medios, y el NodeInstantiator no los volverá a crear a menos que cambien las propiedades del NodeInstantiator.

Documentación de propiedades

active : bool

Cuando el valor de «active» es « true » y el componente delegado está listo, el Instantiator creará objetos según el modelo. Cuando el valor de «active» es « false », no se crearán objetos y se destruirán los objetos creados anteriormente.

El valor por defecto es true.

asynchronous : bool

Cuando «asynchronous» es «true», el Instantiator intentará crear objetos de forma asíncrona. Esto significa que es posible que los objetos no estén disponibles de inmediato, incluso si «active» está establecido en «true».

Puedes utilizar la señal « objectAdded » para recibir notificaciones sobre los elementos que se están creando.

El valor por defecto es « false ».

count : int [read-only]

El número de objetos que el Instantiator gestiona actualmente.

delegate : QtQml::Component [default]

El componente utilizado para crear todos los objetos.

Ten en cuenta que habrá una variable adicional, «index», disponible dentro de las instancias del delegado. Esta variable hace referencia al índice de la instancia dentro del Instantiator y puede utilizarse para obtener el objeto mediante el método «itemAt» del Instantiator.

Si se modifica esta propiedad, todas las instancias que utilicen el delegado anterior se destruirán y se crearán nuevas instancias utilizando el nuevo delegado.

model : variant

Esta propiedad se puede configurar con cualquiera de los modelos de datos compatibles:

  • Un número que indica el número de delegados que debe crear el repetidor
  • Un modelo (por ejemplo, un elemento de tipo `ListModel` o una subclase de ` QAbstractItemModel `)
  • Una lista de cadenas
  • Una lista de objetos

El tipo de modelo influye en las propiedades que se exponen a la clase ` delegate`.

El valor por defecto es 1, lo que crea una única instancia de delegado.

Véase también Modelos de datos.

object : QtQml::QtObject [read-only]

Se trata de una referencia al primer objeto creado, pensada para facilitar las cosas en los casos en los que solo se haya creado un objeto.

Documentación de Signal

objectAdded(int index, QtObject object)

Esta señal se emite cuando se añade un nodo a la lista « NodeInstantiator ». El parámetro « index » contiene el índice que se le ha asignado al nodo, y el parámetro « object » contiene el nodo « Node » que se ha añadido.

El controlador correspondiente es onNodeAdded.

Nota: El controlador correspondiente es onObjectAdded.

objectRemoved(int index, QtObject object)

Esta señal se emite cuando se elimina un objeto del Instantiator. El parámetro « index » contiene el índice que se le había asignado al objeto, y el parámetro « object » contiene el « QtObject » que se ha eliminado.

No mantengas una referencia a ` object ` si ha sido creado por este Instantiator, ya que en estos casos se eliminará poco después de que se gestione la señal.

El controlador correspondiente es onObjectRemoved.

Nota: El controlador correspondiente es onObjectRemoved.

Documentación del método

object objectAt(int index)

Devuelve una referencia al objeto con el ` index` indicado.

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