ExtendedAttributes QML Type

Le type « ExtendedAttributes » contient des données supplémentaires concernant une « Place ». En savoir plus...

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

Signaux

• void valueChanged(string key, variant value)

Méthodes

• variant keys()

Description détaillée

Le type ExtendedAttributes est une carte d'placeAttributes. Pour accéder aux attributs de la carte, utilisez la méthode keys() afin d'obtenir la liste des clés stockées dans la carte, puis utilisez l'opérateur [] pour accéder aux éléments placeAttribute.

Voici les clés standard définies par l’API. Les implémentations de Plugin sont libres de définir des clés supplémentaires. Les clés personnalisées doivent être précédées d’un préfixe unique afin d’éviter tout conflit.

Certains plugins peuvent ne pas prendre en charge les attributs du tout, d'autres peuvent n'en prendre en charge qu'un certain ensemble, d'autres encore peuvent prendre en charge un ensemble d'attributs évoluant dynamiquement au fil du temps, voire permettre aux attributs d'être définis arbitrairement par l'application cliente. Les attributs peuvent également varier d'un lieu à l'autre ; par exemple, un lieu peut disposer d'horaires d'ouverture tandis qu'un autre n'en a pas. Consultez la documentation des plugins pour plus de détails.

Certains attributs ne sont pas destinés à être lus par les utilisateurs finaux ; le champ « label » de ces attributs est vide pour indiquer ce fait.

L'exemple suivant montre comment accéder à tous les objets ` placeAttributes ` et les afficher dans la console :

import QtPositioning
import QtLocation

function printExtendedAttributes(extendedAttributes) {
    var keys = extendedAttributes.keys();
    for (var i = 0; i < keys.length; ++i) {
        var key = keys[i];
        if (extendedAttributes[key].label !== "")
            console.log(extendedAttributes[key].label + ": " + extendedAttributes[key].text);
    }
}

L'exemple suivant montre comment attribuer et modifier un attribut :

    //assign a new attribute to a place
    var smokingAttrib = Qt.createQmlObject('import QtLocation; PlaceAttribute {}', place);
    smokingAttrib.label = "Smoking Allowed"
    smokingAttrib.text = "No"
    place.extendedAttributes.smoking = smokingAttrib;

    //modify an existing attribute
    place.extendedAttributes.smoking.text = "Yes"

Voir également placeAttribute et QQmlPropertyMap.

Documentation Signal

void valueChanged(string key, variant value)

Ce signal est émis lorsque l'ensemble des attributs change. key est la clé correspondant à l'value qui a été modifiée.

Le gestionnaire correspondant est onValueChanged.

Documentation de la méthode

variant keys()

Renvoie un tableau contenant les clés des attributs de lieu actuellement enregistrés dans la carte.