Repeater3D QML Type
Instancie un certain nombre de composants basés sur des nœuds à l'aide d'un modèle fourni. Plus d'informations...
| 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 est utilisé pour créer un grand nombre d'éléments similaires. Comme les autres types de vues, un Repeater3D possède un model et un delegate: pour chaque entrée du modèle, le délégué est instancié dans un contexte alimenté par les données du modèle.
Le site model d'un Repeater peut être n'importe lequel des modèles de données pris en charge. En outre, comme les délégués d'autres vues, le délégué d'un Repeater peut accéder à son index dans le Repeater, ainsi qu'aux données du modèle pertinentes pour le délégué. Pour plus de détails, voir la documentation sur la propriété delegate.
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 dans le modèle.
Remarque : Le nombre d'éléments du modèle indiqué par count peut différer du nombre de délégués créés si le site Repeater3D est en train d'instancier des délégués ou si sa configuration est incorrecte.
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 à une propriété index en lecture seule qui indique l'index du délégué dans le répéteur.
Si l'objet model est un objet modèle (tel que ListModel), le délégué peut accéder à tous les rôles du modèle en tant que 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 les modèles de données QML.
delegateModelAccess : enumeration [since 6.10]
Cette propriété détermine comment les délégués peuvent accéder au modèle.
| Constante | Description |
|---|---|
DelegateModel.ReadOnly | Interdit aux délégués d'écrire le modèle via les propriétés du contexte, l'objet model ou les propriétés requises. |
DelegateModel.ReadWrite | Autorise les délégués à écrire le modèle via les propriétés du contexte, l'objet model ou les propriétés requises. |
DelegateModel.Qt5ReadWrite | Autorise les délégués à écrire le modèle via l'objet model et les propriétés de contexte, mais pas via les propriétés requises. |
La valeur par défaut est DelegateModel.Qt5ReadWrite.
Cette propriété a été introduite dans Qt 6.10.
Voir aussi Modèles et vues dans Qt Quick#ChangingModel Data.
model : any
Le modèle fournissant les données pour le 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 qui indique 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 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 à 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 auquel l'objet a été inséré dans le répéteur, et le paramètre object contient le Object3D qui a été ajouté.
Le gestionnaire correspondant est onObjectAdded.
Note : Le gestionnaire correspondant est onObjectAdded.
objectRemoved(int index, Object3D object)
Ce signal est émis lorsqu'un objet est retiré du répéteur. Le paramètre index contient l'index auquel l'élément a été retiré du répéteur, et le paramètre object contient le Object3D qui a été retiré.
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 de temps après le traitement du signal.
Le gestionnaire correspondant est onObjectRemoved.
Note : Le gestionnaire correspondant est onObjectRemoved.
Documentation de la méthode
Object3D objectAt(index)
Renvoie l'adresse Object3D qui a été créée à l'adresse index, ou 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.
