Repeater3D QML Type
Crea varias instancias de componentes basados en Node utilizando un modelo proporcionado. Más...
| Import Statement: | import QtQuick3D |
| Inherits: | |
| Inherited By: |
Propiedades
- count : int
- delegate : Component
- delegateModelAccess : enumeration
(since 6.10) - model : any
Señales
- objectAdded(int index, Object3D object)
- objectRemoved(int index, Object3D object)
Métodos
- Object3D objectAt(index)
Descripción detallada
El tipo Repeater3D se utiliza para crear un gran número de elementos similares. Al igual que otros tipos de vista, un Repeater3D tiene un delegado de vista ( model ) y un delegado de repetidor ( delegate): para cada entrada del modelo, el delegado se instancia en un contexto inicializado con datos del modelo.
El model de un Repeater puede ser cualquiera de los modelos de datos compatibles. Además, al igual que los delegados de otras vistas, un delegado de Repeater puede acceder a su índice dentro del repetidor, así como a los datos del modelo relevantes para el delegado. Consulta la documentación de la propiedad delegate para obtener más detalles.
Nota: Un elemento Repeater3D es propietario de todos los elementos que instancia. Eliminar o destruir dinámicamente un elemento creado por un Repeater3D da lugar a un comportamiento impredecible.
Documentación de propiedades
count : int [read-only]
Esta propiedad contiene el número de elementos del modelo.
Nota: El número de elementos del modelo que indica la propiedad «count» puede diferir del número de delegados creados si el « Repeater3D » está en proceso de instanciar delegados o está configurado incorrectamente.
delegate : Component [default]
El delegado proporciona una plantilla que define cada objeto instanciado por el repetidor.
Los delegados tienen acceso a una propiedad de solo lectura index que indica el índice del delegado dentro del repetidor.
Si el ` model ` es un objeto de modelo (como un ` ListModel`), el delegado puede acceder a todas las funciones del modelo como propiedades con nombre, del mismo modo que lo hacen los delegados para clases de vista como ` ListView`.
Véase también Modelos de datos QML.
delegateModelAccess : enumeration [since 6.10]
Esta propiedad determina cómo pueden acceder los delegados al modelo.
| Constante | Descripción |
|---|---|
DelegateModel.ReadOnly | Impide que los delegados escriban en el modelo a través de las propiedades de contexto, el objeto ` model ` o las propiedades obligatorias. |
DelegateModel.ReadWrite | Permite a los delegados escribir en el modelo a través de las propiedades de contexto, el objeto ` model ` o las propiedades obligatorias. |
DelegateModel.Qt5ReadWrite | Permite 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 : any
El modelo que proporciona datos al repetidor.
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.
Véase también Modelos de datos.
Documentación de Signal
objectAdded(int index, Object3D object)
Esta señal se emite cuando se añade un objeto al repetidor. El parámetro « index » contiene el índice en el que se ha insertado el objeto dentro del repetidor, y el parámetro « object » contiene el « Object3D » que se ha añadido.
El controlador correspondiente es onObjectAdded.
Nota: El controlador correspondiente es onObjectAdded.
objectRemoved(int index, Object3D object)
Esta señal se emite cuando se elimina un objeto del repetidor. El parámetro « index » contiene el índice en el que se eliminó el elemento del repetidor, y el parámetro « object » contiene el « Object3D » que se ha eliminado.
No mantengas una referencia a object si fue creado por este repetidor, 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
Object3D objectAt(index)
Devuelve el objeto ` Object3D ` que se ha creado en la dirección ` index`, o en ` null ` si no existe ningún elemento en ` index`.
© 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.