CategoryModel QML Type

Der Typ „CategoryModel“ stellt ein Modell der Kategorien bereit, die von einem „ Plugin “ unterstützt werden. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• hierarchical : bool
• plugin : Plugin
• status : enumeration

Signale

• dataChanged()

Methoden

• string errorString()

Ausführliche Beschreibung

Der Typ „CategoryModel“ stellt ein Modell der Kategorien bereit, die im aktuellen „ Plugin “ verfügbar sind. Das Modell unterstützt sowohl eine flache Liste von Kategorien als auch eine hierarchische Baumstruktur, die Kategoriegruppierungen darstellt. Dies kann über die Eigenschaft „ hierarchical “ gesteuert werden.

Das Modell unterstützt die folgenden Rollen:

Das folgende Beispiel zeigt eine flache Liste aller 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 Kategorie-Modell zuzugreifen, muss ein „ DelegateModel “ verwendet werden, um auf die untergeordneten Elemente zuzugreifen.

Dokumentation der Eigenschaften

hierarchical : bool

Diese Eigenschaft gilt unabhängig davon, ob das Modell eine hierarchische Baumstruktur mit Kategorien oder eine flache Liste bereitstellt. Der Standardwert ist „true“.

plugin : Plugin

Diese Eigenschaft enthält die vom Modell verwendete Anbieter- Plugin.

status : enumeration [read-only]

Diese Eigenschaft gibt den Status des Modells an. Mögliche Werte sind:

Signaldokumentation

dataChanged()

Dieses Signal wird ausgegeben, wenn wesentliche Änderungen am zugrunde liegenden Datenspeicher vorgenommen wurden.

Anwendungen sollten nach eigenem Ermessen auf dieses Signal reagieren. Die vom Modell bereitgestellten Daten könnten veraltet sein, weshalb das Modell zu gegebener Zeit erneut aktualisiert werden sollte; eine sofortige Aktualisierung könnte jedoch für die Benutzer verwirrend sein, wenn sich die Kategorien ändern, ohne dass sie selbst etwas dazu beitragen.

Der entsprechende Handler lautet „ onDataChanged “.

Methodendokumentation

string errorString()

Diese schreibgeschützte Eigenschaft enthält die textuelle Darstellung des letzten Fehlers im Kategoriemodell. 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 keine textuelle Darstellung vorhanden ist.