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
- hierarchical : bool
- plugin : Plugin
- status : enumeration
Signaux
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 :
| Rôle | Type de rôle | Description de la catégorie |
|---|---|---|
| catégorie | Category | Objet de catégorie pour l'élément actuel. |
| parentCategory | Category | Objet 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.
status : enumeration |
Cette propriété indique l'état du modèle. Il peut s'agir de l'un des éléments suivants
| CategoryModel.Null | Aucune requête de recherche de catégorie n'a été exécutée. Le modèle est vide. |
| CategoryModel.Ready | Aucune 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.Loading | Le 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. |
| CategoryModelErreur | Une 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.