Category QML Type

Le type « Catégorie » représente une catégorie à laquelle une « Place » peut être associée. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

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 permettent de rechercher des lieux en fonction des catégories auxquelles ils sont associés. La liste des catégories disponibles peut être consultée à l'adresse CategoryModel. L'PlaceSearchModel dispose d'une propriété categories qui permet de limiter les résultats de recherche aux lieux appartenant aux catégories spécifiées.

Si l'objet ` Plugin ` le prend en charge, il est possible de créer ou de supprimer des catégories. Pour créer une nouvelle catégorie, créez un nouvel objet `Category`, définissez ses propriétés, puis appelez 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, puis appelez la méthode ` remove()`.

Voir également 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 de l'plugin.

icon : PlaceIcon

Cette propriété contient la source de l'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 appartient la catégorie.

status : enumeration [read-only]

Cette propriété contient le statut de la catégorie. Elle peut prendre l'une des valeurs suivantes :

visibility : enumeration

Cette propriété définit la visibilité de la catégorie. Elle peut prendre l'une des valeurs suivantes :

Notez que la visibilité n'affecte pas la manière dont les « Places » associés à la catégorie s'affichent dans l'interface utilisateur d'une application sur l'appareil. Elle définit plutôt les règles de partage de la catégorie.

Documentation des méthodes

string errorString()

Renvoie une chaîne de caractères décrivant l'erreur survenue lors 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'administration.

void save()

Cette méthode enregistre la catégorie dans le service d'administration.