CategoryModel QML Type

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

Import Statement: import QtLocation 6.10
Since: QtLocation 5.5

Propriétés

Signaux

Méthodes

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 :

RôleType de rôleDescription de la catégorie
catégorieCategoryObjet de catégorie pour l'élément actuel.
parentCategoryCategoryObjet de catégorie parent pour l'élément actuel. S'il n'y a pas de parent, null est renvoyé.

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.

Propriété Documentation

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é indique le fournisseur Plugin utilisé par ce modèle.


status : enumeration [read-only]

Cette propriété indique l'état du modèle. Il peut s'agir de l'un des éléments suivants

CategoryModel.NullAucune requête de recherche de catégorie n'a été exécutée. Le modèle est vide.
CategoryModel.ReadyAucune erreur ne s'est produite lors de la dernière opération, d'autres opérations peuvent être effectuées sur le modèle.
CategoryModel.LoadingLe modèle est en cours de mise à jour, aucune autre opération ne peut être effectuée tant qu'elle n'est pas terminée.
CategoryModelErreurUne erreur s'est produite lors de la dernière opération, d'autres opérations peuvent encore être effectuées sur le modèle.

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 sur 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 donné. 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.

Note : 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 en cas d'erreur n'ayant pas de représentation textuelle associée.


© 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.