ContactDetails QML Type

Der Typ ContactDetails enthält Kontaktinformationen für eine Place. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Methoden

• variant keys()

Detaillierte Beschreibung

Der Typ ContactDetails ist eine Karte von contactDetail Objekten. Um auf die Kontaktdaten in der Map zuzugreifen, verwenden Sie die Methode keys(), um die Liste der in der Map gespeicherten Schlüssel zu erhalten, und verwenden Sie dann den Operator [], um auf die contactDetail Elemente zuzugreifen.

Die folgenden Schlüssel sind in der API definiert. Plugin Implementierungen steht es frei, weitere Schlüssel zu definieren.

• Telefon
• Fax
• E-Mail
• Website

ContactDetails-Instanzen werden immer nur im Kontext von Places verwendet. Es ist nicht möglich, eine ContactDetails-Instanz direkt zu erstellen oder ContactDetails-Instanzen Places neu zuzuordnen. Änderungen an ContactDetails können nur über Javascript vorgenommen werden.

Beispiele

Das folgende Beispiel zeigt, wie man auf alle contact details zugreifen und sie auf der Konsole ausgeben kann:

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);
        }
    }
}

Die zurückgegebene Liste der Kontaktdetails ist eine Objektliste und kann somit direkt als Datenmodell verwendet werden. Das folgende Beispiel zeigt, wie man eine Liste von Kontakttelefonnummern in einer Listenansicht anzeigt:

import QtQuick
import QtPositioning
import QtLocation

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

Das folgende Beispiel zeigt, wie man in JavaScript eine einzelne Telefonnummer einem Ort zuordnet:

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

Das folgende Beispiel zeigt, wie man in JavaScript mehrere Telefonnummern einem Ort zuordnet:

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;
}

Dokumentation der Methode