Sur cette page

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

Méthodes

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.ReadyAucune 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.SavingLa 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.SuppressionLa 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.ErreurUne 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.UnspecifiedVisibilityLa 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.DeviceVisibilityLa catégorie est limitée à l'appareil actuel. La catégorie ne sera pas transférée hors de l'appareil.
Catégorie.PrivateVisibilityLa 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.PublicVisibilityLa 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.