ContactInstantMessageField class (Windows)

This topic has not yet been rated - Rate this topic

Defines a field that is an instant messaging (IM) address.

Syntax


var contactInstantMessageField = new Windows.ApplicationModel.Contacts.ContactInstantMessageField(string);
var contactInstantMessageField = new Windows.ApplicationModel.Contacts.ContactInstantMessageField(string, contactFieldCategory);
var contactInstantMessageField = new Windows.ApplicationModel.Contacts.ContactInstantMessageField(string, contactFieldCategory, string, string, uri);

Attributes

ActivatableAttribute(Windows.ApplicationModel.Contacts.IContactInstantMessageFieldFactory, NTDDI_WIN8)
MarshalingBehaviorAttribute(Agile)
VersionAttribute(NTDDI_WIN8)

Members

The ContactInstantMessageField class has these types of members:

Constructors
Methods
Properties

Constructors

The ContactInstantMessageField class has these constructors.

Constructor	Description
ContactInstantMessageField(String)	Creates a new ContactInstantMessageField object.
ContactInstantMessageField(String, ContactFieldCategory)	Creates a new ContactInstantMessageField object.
ContactInstantMessageField(String, ContactFieldCategory, String, String, Uri)	Creates a new ContactInstantMessageField object.

Methods

The ContactInstantMessageField class inherits methods from the Object class (C#/VB/C++).

Properties

The ContactInstantMessageField class has these properties.

Property	Access type	Description
Category	Read-only	Gets the category for the contact data.
DisplayText	Read-only	Gets the display text for the Uniform Resource Identifier (URI) that starts an instant message.
LaunchUri	Read-only	Gets the Uniform Resource Identifier (URI) that can start an instant message.
Name	Read-only	Gets the name of the field.
Service	Read-only	Gets the name of the service used for sending instant messages.
Type	Read-only	Gets the contact field type for the data.
UserName	Read-only	Gets the user's name.
Value	Read-only	Gets the value of the contact data.

Remarks

Your app receives a collection of ContactInstantMessageField objects when a contact provider returns the requested contact information. You can access these objects through the ContactInformation.InstantMessages property.

Examples

This code demonstrates the use of the ContactInstantMessageField object.

JavaScript


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 [Windows Store apps only]
Minimum supported server	Windows Server 2012 [Windows Store apps only]
Namespace	Windows.ApplicationModel.Contacts Windows::ApplicationModel::Contacts [C++]
Metadata	Windows.winmd

Build date: 12/4/2012

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)