ContactInformation.InstantMessages | instantMessages property

Applies to Windows and Windows Phone

[ContactInformation may be altered or unavailable for releases after Windows 8.1. Instead, use Contact. ]

A read-only list of instant messaging accounts stored with the contact.

Syntax


var instantMessages = contactInformation.instantMessages;

Property value

Type: IVectorView<ContactInstantMessageField> [JavaScript/C++] | System.Collections.Generic.IReadOnlyList<ContactInstantMessageField> [.NET]

A read-only list of instant messaging accounts.

Remarks

Use the InstantMessages property to access a contact's instant messaging user names from a ContactInformation object.

Examples

This code demonstrates the use of the InstantMessages property.


function getInstantMessageInfo() {
    var picker = Windows.ApplicationModel.Contacts.ContactPicker();
    picker.commitButtonText = "Select";
    picker.selectionMode = Windows.ApplicationModel.Contacts.ContactSelectionMode.fields;
    picker.desiredFields.append(Windows.ApplicationModel.Contacts.KnownContactField.instantMessage);
    picker.pickSingleContactAsync().then(function (contact) {
        var contactElement = document.createElement("div");
        var contactData = contact.name + "<br/>";
        contactData += contact.instantMessages[0].displayText + "<br/>";
        contactData += contact.instantMessages[0].launchUri + "<br/>";
        contactData += contact.instantMessages[0].service + "<br/>";
        contactData += contact.instantMessages[0].userName + "<br/>";
        contactData += contact.instantMessages[0].category + "<br/>";
        contactData += contact.instantMessages[0].type;
        contactElement.innerHTML = contactData;
        document.body.appendChild(contactElement);
    });
}


Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.ApplicationModel.Contacts
Windows::ApplicationModel::Contacts [C++]

Metadata

Windows.winmd

See also

ContactInformation

 

 

Show:
© 2014 Microsoft