Repeater3D QML Type
Instancie plusieurs composants basés sur des nœuds à l'aide d'un modèle fourni. En savoir plus...
| Import Statement: | import QtQuick3D |
| Inherits: | |
| Inherited By: |
Propriétés
- count : int
- delegate : Component
- delegateModelAccess : enumeration
(since 6.10) - model : any
Signaux
- objectAdded(int index, Object3D object)
- objectRemoved(int index, Object3D object)
Méthodes
- Object3D objectAt(index)
Description détaillée
Le type Repeater3D sert à créer un grand nombre d'éléments similaires. À l'instar des autres types de vue, un Repeater3D dispose d'un délégué d'model et d'un délégué d'delegate: pour chaque entrée du modèle, le délégué est instancié dans un contexte initialisé avec les données du modèle.
L'model d'un Repeater peut être n'importe lequel des modèles de données pris en charge. De plus, à l'instar des délégués des autres vues, un délégué Repeater peut accéder à son index au sein du Repeater, ainsi qu'aux données du modèle qui le concernent. Reportez-vous à la documentation de la propriété delegate pour plus de détails.
Remarque : un élément Repeater3D est propriétaire de tous les éléments qu’il instancie. La suppression ou la destruction dynamique d’un élément créé par un Repeater3D entraîne un comportement imprévisible.
Documentation sur les propriétés
count : int [read-only]
Cette propriété contient le nombre d'éléments du modèle.
Remarque : le nombre d'éléments du modèle tel qu'indiqué par la propriété « count » peut différer du nombre de délégués créés si l'Repeater3D est en train d'instancier des délégués ou si elle est mal configurée.
delegate : Component [default]
Le délégué fournit un modèle définissant chaque objet instancié par le répéteur.
Les délégués sont exposés via une propriété en lecture seule, ` index `, qui indique l'index du délégué au sein du répéteur.
Si l’ model est un objet modèle (tel qu’un ListModel), le délégué peut accéder à tous les rôles du modèle sous forme de propriétés nommées, de la même manière que les délégués le font pour les classes de vue telles que ListView.
Voir également Modèles de données QML.
delegateModelAccess : enumeration [since 6.10]
Cette propriété détermine la manière dont les délégués peuvent accéder au modèle.
| Constante | Description |
|---|---|
DelegateModel.ReadOnly | Interdit aux délégués d'écrire dans le modèle via les propriétés de contexte, l'objet ` model ` ou les propriétés obligatoires. |
DelegateModel.ReadWrite | Autorise les délégués à écrire dans le modèle via les propriétés de contexte, l’objet ` model ` ou les propriétés obligatoires. |
DelegateModel.Qt5ReadWrite | Autorise les délégués à modifier le modèle via l'objet ` model ` et les propriétés de contexte, mais pas via les propriétés obligatoires. |
La valeur par défaut est ` DelegateModel.Qt5ReadWrite`.
Cette propriété a été introduite dans Qt 6.10.
Voir également Modèles et vues dans Qt Quick#Modification des données du modèle.
model : any
Le modèle fournissant les données au répéteur.
Cette propriété peut être définie sur n'importe lequel des modèles de données pris en charge :
- Un nombre indiquant le nombre de délégués à créer par le répéteur
- Un modèle (par exemple, un élément « ListModel » ou une sous-classe de « QAbstractItemModel »)
- Une liste de chaînes de caractères
- Une liste d'objets
Le type de modèle influe sur les propriétés exposées à l'delegate.
Voir également Modèles de données.
Documentation sur les signaux
objectAdded(int index, Object3D object)
Ce signal est émis lorsqu'un objet est ajouté au répéteur. Le paramètre « index » contient l'index à l'index duquel l'objet a été inséré dans le répéteur, et le paramètre « object » contient l'Object3D s de l'objet ajouté.
Le gestionnaire correspondant est onObjectAdded.
Remarque : le gestionnaire correspondant est onObjectAdded.
objectRemoved(int index, Object3D object)
Ce signal est émis lorsqu'un objet est supprimé du répéteur. Le paramètre « index » contient l'index à partir duquel l'élément a été supprimé du répéteur, et le paramètre « object » contient l'Object3D qui a été supprimée.
Ne conservez pas de référence à object s’il a été créé par ce répéteur, car dans ce cas, il sera supprimé peu après le traitement du signal.
Le gestionnaire correspondant est onObjectRemoved.
Remarque : le gestionnaire correspondant est ` onObjectRemoved`.
Documentation des méthodes
Object3D objectAt(index)
Renvoie l'Object3D créé à l'adresse index, ou à l'adresse null si aucun élément n'existe à l'adresse 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.