CategoryModel QML Type

Le type `CategoryModel` fournit un modèle des catégories prises en charge par un ` Plugin`. En savoir 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 à partir de l'Plugin. Le modèle prend en charge à la fois une liste plate de catégories et une arborescence hiérarchique représentant des regroupements de catégories. Ce comportement 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 hiérarchique des catégories, il est nécessaire d'utiliser une instance de ` DelegateModel ` afin d'accéder aux éléments enfants.

Documentation des propriétés

hierarchical : bool

Cette propriété s'applique que le modèle fournisse une arborescence hiérarchique de catégories ou une liste plate. La valeur par défaut est « true ».

plugin : Plugin

Cette propriété contient l'Plugin du fournisseur utilisée par ce modèle.

status : enumeration [read-only]

Cette propriété indique l'état du modèle. Elle peut prendre l'une des valeurs suivantes :

Documentation sur les signaux

dataChanged()

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

Les applications doivent réagir à ce signal à leur entière discrétion. Les données fournies par le modèle pouvant être obsolètes, celui-ci doit être mis à jour à un moment donné ; toutefois, une mise à jour immédiate pourrait déconcerter les utilisateurs si les catégories changent sans qu'ils aient à intervenir.

Le gestionnaire correspondant est onDataChanged.

Documentation de la méthode

string errorString()

Cette propriété en lecture seule contient la représentation textuelle de la dernière erreur du 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 qui ne dispose d'aucune représentation textuelle associée.