CategoryModel QML Type

Der Typ CategoryModel bietet ein Modell der Kategorien, 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()

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:

Im folgenden Beispiel wird eine flache Liste aller verfügbaren Kategorien angezeigt:

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.

Dokumentation der Eigenschaft

hierarchical : bool

Diese Eigenschaft gibt an, ob das Modell einen hierarchischen Baum von Kategorien oder eine flache Liste enthält. Der Standardwert ist true.

plugin : Plugin

Diese Eigenschaft enthält den von diesem Modell verwendeten Anbieter Plugin.

status : enumeration [read-only]

Diese Eigenschaft enthält den Status des Modells. Sie kann eine der folgenden sein:

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.

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 Zeichenfolge kann auch zurückgegeben werden, wenn ein Fehler aufgetreten ist, der keine zugehörige textuelle Darstellung hat.