ContactInstantMessageField クラス

ContactInstantMessageField Class

[ContactInstantMessageField は、Windows 8.1 より後のリリースでは、変更されるか使用できなくなる可能性があります。代わりに、ContactConnectedServiceAccount を使用してください。]

インスタント メッセージング (IM) アドレスであるフィールドを定義します。

構文


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);

属性

[Deprecated()]
[MarshalingBehavior(Agile)]
[Version(0x06020000)]

メンバー

ContactInstantMessageFieldクラス には次の種類のメンバーがあります。

コンストラクター

ContactInstantMessageFieldクラス にはこれらのコンストラクターがあります。

コンストラクター説明
ContactInstantMessageField(String) IContactInstantMessageFieldFactory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactConnectedServiceAccount. Creates a new ContactInstantMessageField object.
ContactInstantMessageField(String, ContactFieldCategory) IContactInstantMessageFieldFactory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactConnectedServiceAccount. Creates a new ContactInstantMessageField object.
ContactInstantMessageField(String, ContactFieldCategory, String, String, Uri) IContactInstantMessageFieldFactory may be altered or unavailable for releases after Windows 8.1. Instead, use ContactConnectedServiceAccount. Creates a new ContactInstantMessageField object.

 

メソッド

The ContactInstantMessageField クラス からメソッドを継承します。Object クラス (C#/VB/C++).

プロパティ

ContactInstantMessageFieldクラス には次のプロパティがあります。

プロパティアクセスの種類説明

Category

読み取り専用IContactField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress, ContactPhone, ContactSignificantOther, Contact, ContactEmail, ContactConnectedServiceAccount, ContactWebsite, ContactJobInfo, or ContactDate. Gets the category for the contact data.

DisplayText

読み取り専用ContactInstantMessageField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactConnectedServiceAccount. Gets the display text for the Uniform Resource Identifier (URI) that starts an instant message.

LaunchUri

読み取り専用ContactInstantMessageField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactConnectedServiceAccount. Gets the Uniform Resource Identifier (URI) that can start an instant message.

Name

読み取り専用IContactField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress, ContactPhone, ContactSignificantOther, Contact, ContactEmail, ContactConnectedServiceAccount, ContactWebsite, ContactJobInfo, or ContactDate. Gets the name of the field.

Service

読み取り専用ContactInstantMessageField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactConnectedServiceAccount. Gets the name of the service used for sending instant messages.

Type

読み取り専用IContactField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress, ContactPhone, ContactSignificantOther, Contact, ContactEmail, ContactConnectedServiceAccount, ContactWebsite, ContactJobInfo, or ContactDate. Gets the contact field type for the data.

UserName

読み取り専用ContactInstantMessageField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactConnectedServiceAccount. Gets the user's name.

Value

読み取り専用IContactField may be altered or unavailable for releases after Windows 8.1. Instead, use ContactAddress, ContactPhone, ContactSignificantOther, Contact, ContactEmail, ContactConnectedServiceAccount, ContactWebsite, ContactJobInfo, or ContactDate. Gets the value of the contact data.

 

解説

連絡先プロバイダーが要求された連絡先情報を返すとき、アプリケーションは ContactInstantMessageField オブジェクトのコレクションを受け取ります。これらのオブジェクトには ContactInformation.InstantMessages プロパティを通じてアクセスできます。

このコードは、ContactInstantMessageField オブジェクトの使用方法を示しています。


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);
    });
}


要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

名前空間

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

メタデータ

Windows.winmd

 

 

表示:
© 2016 Microsoft