ContactDetails QML Type

Le type ContactDetails contient les coordonnées d'un Place. Plus....

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

Méthodes

• variant keys()

Description détaillée

Le type ContactDetails est une carte d'objets contactDetail. Pour accéder aux coordonnées d'un contact dans la carte, utilisez la méthode keys() pour obtenir la liste des clés stockées dans la carte, puis utilisez l'opérateur [] pour accéder aux éléments contactDetail.

Les clés suivantes sont définies dans l'API. Les implémentations Plugin sont libres de définir des clés supplémentaires.

• téléphone
• fax
• courriel
• site web

Les instances de ContactDetails ne sont jamais utilisées que dans le contexte de Places. Il n'est pas possible de créer directement une instance de ContactDetails ou de réaffecter des instances de ContactDetails à Places. La modification de ContactDetails ne peut se faire que par l'intermédiaire de Javascript.

Exemples

L'exemple suivant montre comment accéder à tous les contact details et les imprimer sur la console :

import QtPositioning
import QtLocation

function printContactDetails(contactDetails) {
    var keys = contactDetails.keys();
    for (var i = 0; i < keys.length; ++i) {
        var contactList = contactDetails[keys[i]];
        for (var j = 0; j < contactList.length; ++j) {
            console.log(contactList[j].label + ": " + contactList[j].value);
        }
    }
}

La liste des coordonnées renvoyée est une liste d'objets et peut donc être utilisée directement comme modèle de données. Par exemple, l'exemple suivant montre comment afficher une liste de numéros de téléphone de contacts dans une vue en liste :

import QtQuick
import QtPositioning
import QtLocation

ListView {
    model: place.contactDetails.phone;
    delegate: Text { text: modelData.label + ": " + modelData.value }
}

L'exemple suivant montre comment attribuer un seul numéro de téléphone à un lieu en JavaScript :

function writeSingle() {
    var phoneNumber = Qt.createQmlObject('import QtLocation; ContactDetail {}', place);
    phoneNumber.label = "Phone";
    phoneNumber.value = "555-5555"
    place.contactDetails.phone = phoneNumber;
}

L'exemple suivant montre comment attribuer plusieurs numéros de téléphone à un lieu en JavaScript :

function writeMultiple() {
    var bob = Qt.createQmlObject('import QtLocation; ContactDetail {}', place);
    bob.label = "Bob";
    bob.value = "555-5555"

    var alice = Qt.createQmlObject('import QtLocation; ContactDetail {}', place);
    alice.label = "Alice";
    alice.value = "555-8745"

    var numbers = new Array();
    numbers.push(bob);
    numbers.push(alice);

    place.contactDetails.phone = numbers;
}

Documentation de la méthode

variant keys()

Renvoie un tableau de clés de coordonnées actuellement stockées dans la carte.