ContactDetail QML Type

The ContactDetail type holds a contact detail such as a phone number or a website address. More...

Import Statement: import QtLocation 5.3
Since: Qt Location 5.5


Detailed Description

The ContactDetail provides a single detail on how one could contact a Place. The ContactDetail consists of a label, which is a localized string describing the contact method, and a value representing the actual contact detail.


The following example demonstrates how to assign a single phone number to a place in JavaScript:

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

The following demonstrates how to assign multiple phone numbers to a place in JavaScript:

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

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

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

Note, due to limitations of the QQmlPropertyMap, it is not possible to declaratively specify the contact details in QML, it can only be accomplished via JavaScript.

Property Documentation

contactDetail : QPlaceContactDetail

For details on how to use this property to interface between C++ and QML see "Interfaces between C++ and QML Code".

label : string

This property holds a label describing the contact detail.

The label can potentially be localized. The language is dependent on the entity that sets it, typically this is the Plugin. The Plugin::locales property defines what language is used.

value : string

This property holds the value of the contact detail which may be a phone number, an email address, a website url and so on.

© 2017 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.