ContactDetails QML Type (Uncreatable)

Der Typ „ContactDetails“ enthält Kontaktdaten für eine „ Place “. Mehr...

Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Methoden

• variant keys()

Ausführliche Beschreibung

Der Typ „ContactDetails“ ist eine Map aus „ 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 abzurufen, und nutzen Sie anschließend den Operator „ [] “, um auf die „ contactDetail “-Elemente zuzugreifen.

Die folgenden Schlüssel sind in der API definiert. Implementierungen von „ Plugin “ können beliebig weitere Schlüssel definieren.

• phone
• fax
• E-Mail
• website

Instanzen von „ContactDetails“ werden ausschließlich im Zusammenhang mit „ Places “ verwendet. Es ist nicht möglich, eine „ContactDetails“-Instanz direkt zu erstellen oder „ContactDetails“-Instanzen „ Places “ neu zuzuweisen. Änderungen an „ContactDetails“ können nur über JavaScript vorgenommen werden.

Beispiele

Das folgende Beispiel zeigt, wie man auf alle „ contact details “ zugreift und diese in der Konsole ausgibt:

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 Kontaktdaten ist eine Objektliste und kann daher direkt als Datenmodell verwendet werden. Das folgende Beispiel zeigt beispielsweise, wie eine Liste mit Telefonnummern der Kontakte in einer Listenansicht angezeigt wird:

import QtQuick
import QtPositioning
import QtLocation

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

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

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 einem Ort in JavaScript mehrere Telefonnummern zuweist:

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

Methodendokumentation

variant keys()

Gibt ein Array der Schlüssel für Kontaktdaten zurück, die derzeit in der Map gespeichert sind.