ContactDetails QML Type

El tipo ContactDetails contiene los datos de contacto de un Place. Más...

• Lista de todos los miembros, incluidos los heredados

Métodos

• variant keys()

Descripción detallada

El tipo ContactDetails es un mapa de objetos contactDetail. Para acceder a los datos de contacto del mapa, utilice el método keys() para obtener la lista de claves almacenadas en el mapa y, a continuación, utilice el operador [] para acceder a los elementos contactDetail.

Las siguientes claves están definidas en la API. Las implementaciones de Plugin son libres de definir claves adicionales.

• teléfono
• fax
• correo electrónico
• sitio web

Las instancias ContactDetails sólo se utilizan en el contexto de Places. No es posible crear una instancia ContactDetails directamente ni reasignar instancias ContactDetails a Places. La modificación de ContactDetails sólo puede realizarse a través de Javascript.

Ejemplos

El siguiente ejemplo muestra cómo acceder a todos los contact details e imprimirlos en la consola:

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 lista de detalles de contacto devuelta es una lista de objetos y, por tanto, puede utilizarse directamente como modelo de datos. Por ejemplo, el siguiente ejemplo muestra cómo mostrar una lista de números de teléfono de contactos en una vista de lista:

import QtQuick
import QtPositioning
import QtLocation

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

El siguiente ejemplo muestra cómo asignar un único número de teléfono a un lugar en JavaScript:

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

A continuación se muestra cómo asignar varios números de teléfono a un lugar 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;
}

Documentación del método

variant keys()

Devuelve una matriz de claves de datos de contacto almacenadas actualmente en el mapa.