CategoryModel QML Type

Le type CategoryModel fournit un modèle des catégories prises en charge par un site Plugin. Plus....

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Signaux

• dataChanged()

Méthodes

• string errorString()

Description détaillée

Le type CategoryModel fournit un modèle des catégories disponibles sur le site Plugin. Le modèle prend en charge à la fois une liste plate de catégories et un arbre hiérarchique représentant les groupements de catégories. Ceci peut être contrôlé par la propriété hierarchical.

Le modèle prend en charge les rôles suivants :

L'exemple suivant affiche une liste plate de toutes les catégories disponibles :

import QtQuick
import QtPositioning
import QtLocation

ListView {
    model: CategoryModel {
        plugin: myPlugin
        hierarchical: false
    }
    delegate: Text { text: category.name }
}

Pour accéder au modèle de catégorie hiérarchique, il est nécessaire d'utiliser une adresse DelegateModel pour accéder aux éléments enfants.

Documentation sur les propriétés

hierarchical : bool

Cette propriété indique si le modèle fournit un arbre hiérarchique de catégories ou une liste plate. La valeur par défaut est true.

plugin : Plugin

Cette propriété contient le fournisseur Plugin utilisé par ce modèle.

status : enumeration [read-only]

Cette propriété contient le statut du modèle. Elle peut être l'une des suivantes

Signal Documentation

dataChanged()

Ce signal est émis lorsque des modifications importantes ont été apportées au magasin de données sous-jacent.

Les applications doivent agir en fonction de ce signal à leur propre discrétion. Les données fournies par le modèle peuvent être obsolètes et le modèle doit donc être réactualisé à un moment ou à un autre. Toutefois, une réactualisation immédiate peut déconcerter les utilisateurs si les catégories changent sans qu'ils aient fait quoi que ce soit.

Le gestionnaire correspondant est onDataChanged.

Documentation de la méthode

string errorString()

Cette propriété en lecture seule contient la présentation textuelle de la dernière erreur de modèle de catégorie. Si aucune erreur ne s'est produite, une chaîne vide est renvoyée.

Une chaîne vide peut également être renvoyée si une erreur s'est produite sans représentation textuelle associée.