ContactDetails QML Type (Uncreatable)
El tipo «ContactDetails» contiene los datos de contacto de un « Place ». Más información...
| Import Statement: | import QtLocation 6.12 |
| Since: | QtLocation 5.5 |
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
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.
En la API se definen las siguientes claves. Las implementaciones de ` Plugin ` pueden definir claves adicionales libremente.
- phone
- fax
- correo electrónico
- website
Las instancias de «ContactDetails» solo se utilizan en el contexto de « Places ». No es posible crear una instancia de «ContactDetails» directamente ni reasignar instancias de «ContactDetails» a « Places ». La modificación de «ContactDetails» solo puede realizarse mediante JavaScript.
Ejemplos
El siguiente ejemplo muestra cómo acceder a todos los « contact details » y mostrarlos 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 datos de contacto devuelta es una lista de objetos, por lo que puede utilizarse directamente como modelo de datos. Por ejemplo, a continuación se muestra cómo mostrar una lista de números de teléfono de contacto 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 de métodos
variant keys()
Devuelve una matriz con las claves de los datos de contacto almacenados actualmente en el mapa.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.