CategoryModel QML Type
Der Typ CategoryModel bietet ein Modell der Kategorien, die von einem Plugin unterstützt werden. Mehr...
| Import Statement: | import QtLocation 6.8 |
| Since: | QtLocation 5.5 |
Eigenschaften
- hierarchical : bool
- plugin : Plugin
- status : enumeration
Signale
Methoden
- string errorString()
Detaillierte Beschreibung
Der Typ CategoryModel stellt ein Modell der Kategorien bereit, die auf der aktuellen Plugin verfügbar sind. Das Modell unterstützt sowohl eine flache Liste von Kategorien als auch einen hierarchischen Baum, der die Kategoriegruppierungen darstellt. Dies kann über die Eigenschaft hierarchical gesteuert werden.
Das Modell unterstützt die folgenden Rollen:
| Rolle | Typ | Beschreibung |
|---|---|---|
| Kategorie | Category | Kategorieobjekt für den aktuellen Artikel. |
| übergeordneteKategorie | Category | Übergeordnetes Kategorieobjekt für den aktuellen Eintrag. Wenn es keine übergeordnete Kategorie gibt, wird null zurückgegeben. |
Das folgende Beispiel zeigt eine flache Liste mit allen verfügbaren Kategorien an:
import QtQuick import QtPositioning import QtLocation ListView { model: CategoryModel { plugin: myPlugin hierarchical: false } delegate: Text { text: category.name } }
Um auf das hierarchische Kategorienmodell zuzugreifen, ist es notwendig, eine DelegateModel zu verwenden, um auf die untergeordneten Elemente zuzugreifen.
Eigenschaft Dokumentation
hierarchical : bool |
Diese Eigenschaft gibt an, ob das Modell einen hierarchischen Baum von Kategorien oder eine flache Liste liefert. Der Standardwert ist true.
plugin : Plugin |
Diese Eigenschaft enthält den Anbieter Plugin, der von diesem Modell verwendet wird.
status : enumeration |
Diese Eigenschaft enthält den Status des Modells. Sie kann eine der folgenden sein:
| CategoryModel.Null | Es wurde keine Kategorieabfrage ausgeführt. Das Modell ist leer. |
| CategoryModel.Bereit | Bei der letzten Operation ist kein Fehler aufgetreten, weitere Operationen können am Modell durchgeführt werden. |
| CategoryModel.Laden | Das Modell wird gerade aktualisiert, bis zur Fertigstellung können keine weiteren Operationen durchgeführt werden. |
| CategoryModel.Fehler | Bei der letzten Operation ist ein Fehler aufgetreten, weitere Operationen können noch am Modell durchgeführt werden. |
Signal Dokumentation
dataChanged() |
Dieses Signal wird ausgegeben, wenn signifikante Änderungen an dem zugrunde liegenden Datenspeicher vorgenommen wurden.
Anwendungen sollten nach eigenem Ermessen auf dieses Signal reagieren. Die vom Modell bereitgestellten Daten könnten veraltet sein, so dass das Modell irgendwann aktualisiert werden sollte. Eine sofortige Aktualisierung kann jedoch für die Benutzer verwirrend sein, wenn sich die Kategorien ohne ihr Zutun ändern.
Der entsprechende Handler ist onDataChanged.
Hinweis: Der entsprechende Handler ist onDataChanged.
Dokumentation der Methode
string errorString() |
Diese schreibgeschützte Eigenschaft enthält die textliche Darstellung des letzten Kategoriemodellfehlers. Wenn kein Fehler aufgetreten ist, wird eine leere Zeichenfolge zurückgegeben.
Eine leere Zeichenkette kann auch zurückgegeben werden, wenn ein Fehler aufgetreten ist, für den es keine zugehörige textuelle Darstellung gibt.
© 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.
