Category QML Type
Le type Catégorie représente une catégorie à laquelle Place peut être associé. Plus d'informations...
| Import Statement: | import QtLocation 6.11 |
| Since: | QtLocation 5.5 |
Propriétés
- categoryId : string
- icon : PlaceIcon
- name : string
- plugin : Plugin
- status : enumeration
- visibility : enumeration
Méthodes
- string errorString()
- void remove()
- void save()
Description détaillée
Les catégories sont utilisées pour rechercher des lieux en fonction des catégories auxquelles ils sont associés. La liste des catégories disponibles peut être obtenue à partir du site CategoryModel. Le site PlaceSearchModel possède une propriété categories qui est utilisée pour limiter les résultats de la recherche aux lieux associés aux catégories spécifiées.
Si le site Plugin le permet, des catégories peuvent être créées ou supprimées. Pour créer une nouvelle catégorie, construisez un nouvel objet Category et définissez ses propriétés, puis invoquez la méthode save().
import QtPositioning import QtLocation Category { id: category plugin: myPlugin name: "New Category" visibility: Category.PrivateVisibility } ... category.save();
Pour supprimer une catégorie, assurez-vous que les propriétés plugin et categoryId sont définies et appelez la méthode remove().
Voir aussi CategoryModel.
Documentation sur les propriétés
categoryId : string
Cette propriété contient l'identifiant de la catégorie. Le categoryId est une chaîne de caractères qui identifie de manière unique cette catégorie au sein des catégories plugin.
icon : PlaceIcon
Cette propriété contient la source d'image associée à la catégorie. Pour afficher l'icône, vous pouvez utiliser le type Image.
name : string
Cette propriété contient le nom de la catégorie sous forme de chaîne de caractères.
plugin : Plugin
Cette propriété contient le service de localisation auquel la catégorie appartient.
status : enumeration [read-only]
Cette propriété contient le statut de la catégorie. Elle peut être l'une des suivantes :
| Category.Ready | Aucune erreur ne s'est produite lors de la dernière opération, d'autres opérations peuvent être effectuées sur la catégorie. |
| Category.Saving | La catégorie est en cours de sauvegarde, aucune autre opération ne peut être effectuée tant que l'opération en cours n'est pas terminée. |
| Catégorie.Suppression | La catégorie est en cours de suppression, aucune autre opération ne peut être effectuée tant que l'opération en cours n'est pas terminée. |
| Catégorie.Erreur | Une erreur s'est produite lors de la dernière opération, d'autres opérations peuvent encore être effectuées sur la catégorie. |
visibility : enumeration
Cette propriété contient la visibilité de la catégorie. Elle peut être l'une des suivantes
| Category.UnspecifiedVisibility | La visibilité de la catégorie n'est pas spécifiée. Lors de l'enregistrement d'une catégorie, le plugin définira automatiquement une visibilité par défaut pour la catégorie enregistrée dans le backend. Cette valeur par défaut dépend de l'implémentation du plugin. |
| Category.DeviceVisibility | La catégorie est limitée à l'appareil actuel. La catégorie ne sera pas transférée hors de l'appareil. |
| Catégorie.PrivateVisibility | La catégorie est privée pour l'utilisateur actuel. La catégorie peut être transférée vers un service en ligne, mais elle n'est jamais visible que par l'utilisateur actuel. |
| Category.PublicVisibility | La catégorie est publique. |
Il convient de noter que la visibilité n'a pas d'incidence sur la manière dont les Placeassociés à la catégorie sont affichés dans l'interface utilisateur d'une application sur l'appareil. Elle définit plutôt la sémantique de partage de la catégorie.
Documentation de la méthode
string errorString()
Renvoie une chaîne de caractères décrivant l'erreur de la dernière opération. Si la dernière opération s'est déroulée avec succès, la chaîne est vide.
void remove()
Cette méthode supprime définitivement la catégorie du service d'arrière-plan.
void save()
Cette méthode permet d'enregistrer la catégorie dans le service d'arrière-plan.
© 2026 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.