Repeater3D QML Type
Instanziiert eine Anzahl von Node-basierten Komponenten unter Verwendung eines bereitgestellten Modells. Mehr...
| Import Statement: | import QtQuick3D |
| Inherits: | |
| Inherited By: |
Eigenschaften
Signale
- objectAdded(int index, Object3D object)
- objectRemoved(int index, Object3D object)
Methoden
- Object3D objectAt(index)
Detaillierte Beschreibung
Der Typ Repeater3D wird verwendet, um eine große Anzahl ähnlicher Elemente zu erstellen. Wie andere Ansichtstypen hat ein Repeater3D einen model und einen delegate: für jeden Eintrag im Modell wird der Delegierte in einem mit Daten aus dem Modell gefüllten Kontext instanziiert.
Ein Repeater's model kann jedes der unterstützten Datenmodelle sein. Zusätzlich, wie Delegaten für andere Ansichten, kann ein Repeater Delegat auf seinen Index innerhalb des Repeaters zugreifen, sowie auf die Modelldaten die für den Delegaten relevant sind. Siehe die Dokumentation der delegate Eigenschaft für Details.
Hinweis: Ein Repeater3D-Element besitzt alle Elemente, die es instanziiert. Das Entfernen oder dynamische Zerstören eines durch einen Repeater3D erstellten Elements führt zu unvorhersehbarem Verhalten.
Eigenschaft Dokumentation
count : int |
Diese Eigenschaft enthält die Anzahl der Elemente im Modell.
Hinweis: Die Anzahl der Elemente im Modell, wie von count berichtet, kann sich von der Anzahl der erstellten Delegaten unterscheiden, wenn die Repeater3D ist in den Prozess der Instanziierung von Delegaten oder ist falsch eingerichtet.
delegate : Component |
Der Delegat bietet eine Vorlage, die jedes vom Repeater instanziierte Objekt definiert.
Delegaten ist eine schreibgeschützte Eigenschaft index zugeordnet, die den Index des Delegaten innerhalb des Repeaters angibt.
Wenn model ein Modellobjekt ist (z. B. ListModel), kann der Delegat auf alle Modellrollen als benannte Eigenschaften zugreifen, so wie es Delegaten für Ansichtsklassen wie ListView tun.
Siehe auch QML Datenmodelle.
model : any |
Das Modell, das Daten für den Repeater bereitstellt.
Diese Eigenschaft kann auf jedes der unterstützten Datenmodelle gesetzt werden:
- Eine Zahl, die die Anzahl der Delegaten angibt, die vom Repeater erstellt werden sollen
- Ein Modell (z. B. ein Element ListModel oder eine Unterklasse QAbstractItemModel )
- Eine String-Liste
- Eine Objektliste
Die Art des Modells wirkt sich auf die Eigenschaften aus, die dem delegate zur Verfügung gestellt werden.
Siehe auch Datenmodelle.
Signal Dokumentation
Dieses Signal wird ausgegeben, wenn ein Objekt zum Repeater hinzugefügt wird. Der Parameter index enthält den Index, an dem das Objekt in den Repeater eingefügt wurde, und der Parameter object enthält das Object3D, das hinzugefügt wurde.
Der entsprechende Handler lautet onObjectAdded.
Hinweis: Der entsprechende Handler ist onObjectAdded.
Dieses Signal wird ausgegeben, wenn ein Objekt aus dem Repeater entfernt wird. Der Parameter index enthält den Index, an dem das Objekt aus dem Repeater entfernt wurde, und der Parameter object enthält den Object3D, der entfernt wurde.
Behalten Sie keinen Verweis auf object, wenn er von diesem Repeater erstellt wurde, da er in diesen Fällen kurz nach der Bearbeitung des Signals gelöscht wird.
Der entsprechende Handler ist onObjectRemoved.
Hinweis: Der entsprechende Handler ist onObjectRemoved.
Dokumentation der Methode
Object3D objectAt(index) |
Gibt das Object3D zurück, das unter dem angegebenen index erstellt wurde, oder null, wenn unter index kein Element existiert.
© 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.
