En esta página

Instantiator QML Type

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

Import Statement: import QtQml.Models

Propiedades

Señales

Métodos

Descripción detallada

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

El elemento «Instantiator» gestionará los objetos que cree. Dichos objetos están vinculados al «Instantiator» y este también puede eliminarlos si cambian sus propiedades. Los objetos también pueden destruirse dinámicamente por otros medios, y el «Instantiator» no los volverá a crear a menos que cambien sus propiedades.

Nota: Instantiator forma parte de QtQml.Models desde la versión 2.14 y de QtQml desde la versión 2.1. La importación de Instantiator a través de QtQml ha quedado obsoleta desde Qt 5.14.

Documentación de propiedades

active : bool

Cuando «active» es «true» y el componente delegado está listo, el Instantiator creará objetos según el modelo. Cuando «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 responder a la creación de elementos.

El valor por defecto es «false».

count : int [read-only]

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

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 « objectAt » 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.

delegateModelAccess : enumeration [since 6.10]

Esta propiedad determina cómo pueden acceder los delegados al modelo.

ConstanteDescripción
DelegateModel.ReadOnlyImpide que los delegados escriban en el modelo a través de las propiedades de contexto, el objeto ` model ` o las propiedades obligatorias.
DelegateModel.ReadWritePermite a los delegados escribir en el modelo a través de las propiedades de contexto, el objeto ` model ` o las propiedades obligatorias.
DelegateModel.Qt5ReadWritePermite a los delegados escribir en el modelo a través del objeto ` model ` y de las propiedades de contexto, pero no a través de las propiedades obligatorias.

El valor predeterminado es ` DelegateModel.Qt5ReadWrite`.

Esta propiedad se introdujo en Qt 6.10.

Véase también «Modelos y vistas» en Qt Quick, apartado «Modificación de los datos del modelo».

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

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

Véase también Modelos de datos.

object : QtObject [read-only]

Se trata de una referencia al primer objeto creado, pensada para facilitar las cosas en el caso de 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 objeto al Instantiator. El parámetro ` index ` contiene el índice que se le ha asignado al objeto, y el parámetro ` object ` contiene el ` QtObject ` que se ha añadido.

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.

Nota: El controlador correspondiente es onObjectRemoved.

Documentación del método

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