ExtendedAttributes QML Type

Le type ExtendedAttributes contient des données supplémentaires sur un Place. 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 de placeAttributes. Pour accéder aux attributs de la carte, utilisez la méthode keys() pour obtenir la liste des clés stockées dans la carte et utilisez l'opérateur [] pour accéder aux éléments placeAttribute.

Les clés suivantes sont des clés standard définies par l'API. Les implémentations Plugin sont libres de définir des clés supplémentaires. Les clés personnalisées doivent être qualifiées par un préfixe unique pour éviter les conflits.

Certains plugins peuvent ne pas prendre en charge les attributs du tout, d'autres peuvent n'en prendre en charge qu'un certain nombre, d'autres encore peuvent prendre en charge un ensemble d'attributs changeant dynamiquement au fil du temps ou même 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 avoir des heures d'ouverture alors qu'un autre n'en a pas. Consultez les références du plugin pour plus de détails.

Certains attributs peuvent ne pas être destinés à être lus par les utilisateurs finaux ; le champ d'étiquette de ces attributs est vide pour l'indiquer.

L'exemple suivant montre comment accéder à tous les placeAttributes et les imprimer sur 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 sur le signal

void valueChanged(string key, variant value)

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

Le gestionnaire correspondant est onValueChanged.

Documentation de la méthode

variant keys()

Renvoie un tableau de clés d'attributs de lieu actuellement stockées dans la carte.