NodeInstantiator QML Type
Crée dynamiquement des nœuds. Plus d'informations...
| Import Statement: | import Qt3D.Core 2.10 |
| Status: | Deprecated |
Propriétés
- active : bool
- asynchronous : bool
- count : int
- delegate : QtQml::Component
- model : variant
- object : QtQml::QtObject
Signaux
- objectAdded(int index, QtObject object)
- objectRemoved(int index, QtObject object)
Méthodes
- QtQml::QtObject objectAt(int index)
Description détaillée
Un NodeInstantiator peut être utilisé pour contrôler la création dynamique de nœuds ou pour créer dynamiquement plusieurs objets à partir d'un modèle.
L'élément NodeInstantiator gère les objets qu'il crée. Ces objets sont liés à l'Instantiateur et peuvent également être supprimés par le NodeInstantiator si les propriétés de ce dernier sont modifiées. Les nœuds peuvent également être détruits dynamiquement par d'autres moyens, et le NodeInstantiator ne les recréera pas à moins que les propriétés du NodeInstantiator ne changent.
Documentation des propriétés
active : bool |
Lorsque la valeur active est true et que le composant délégué est prêt, l'instanciateur crée des objets conformément au modèle. Lorsque la valeur active est false, aucun objet ne sera créé et tous les objets précédemment créés seront détruits.
La valeur par défaut est true.
asynchronous : bool |
Lorsque asynchrone est vrai, l'instanciateur tente de créer des objets de manière asynchrone. Cela signifie que les objets peuvent ne pas être disponibles immédiatement, même si active vaut true.
Vous pouvez utiliser le signal objectAdded pour répondre à la création d'objets.
Le signal par défaut est false.
count : int |
Le nombre d'objets que l'instanciateur gère actuellement.
delegate : QtQml::Component |
Le composant utilisé pour créer tous les objets.
Notez qu'une variable supplémentaire, index, sera disponible dans les instances du délégué. Cette variable fait référence à l'index de l'instance dans l'instanciateur et peut être utilisée pour obtenir l'objet via la méthode itemAt de l'instanciateur.
Si cette propriété est modifiée, toutes les instances utilisant l'ancien délégué seront détruites et de nouvelles instances seront créées en utilisant le nouveau délégué.
model : variant |
Cette propriété peut être définie sur n'importe quel modèle 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 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'adresse delegate.
La valeur par défaut est 1, ce qui crée une seule instance de délégué.
Voir aussi Modèles de données.
object : QtQml::QtObject |
Il s'agit d'une référence au premier objet créé, conçue comme une commodité pour le cas où un seul objet a été créé.
Documentation du signal
Ce signal est émis lorsqu'un nœud est ajouté au site NodeInstantiator. Le paramètre index contient l'index attribué au nœud et le paramètre object contient le site Node qui a été ajouté.
Le gestionnaire correspondant est onNodeAdded.
Remarque : le gestionnaire correspondant est onObjectAdded.
Ce signal est émis lorsqu'un objet est retiré de l'instanciateur. Le paramètre index contient l'index que l'objet a reçu et le paramètre object contient le QtObject qui a été supprimé.
Ne conservez pas de référence à object s'il a été créé par cet instanciateur, car dans ce cas, il sera supprimé peu après le traitement du signal.
Le gestionnaire correspondant est onObjectRemoved.
Note : Le gestionnaire correspondant est onObjectRemoved.
Documentation de la méthode
QtQml::QtObject objectAt(int index) |
Renvoie une référence à l'objet portant le numéro index.
© 2025 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.