ContactManager.ShowContactCard(Contact, Rect, Placement) | showContactCard(Contact, Rect, Placement) Method

查詢使用者之連絡人的作業系統,並且在連絡人資料卡中顯示連絡人資料。

語法


Windows.ApplicationModel.Contacts.ContactManager.showContactCard(contact, selection, preferredPlacement);

參數

contact

型別: Contact

表示應用程式要為其顯示連絡人卡片之連絡人的物件。

contact 至少必須包含 IdEmails 或者 Phones 清單中的電話號碼,才能查詢使用者的連絡人資料庫,以擷取要顯示的相符連絡人。Id 有高優先權的查詢。如果有相符的 Id,比對用途會忽略其餘的查詢參數。如果 Id 找不到符合的項目,查詢會使用其餘的查詢參數。EmailsPhones 比較時的優先權相同。如果提供多個電子郵件地址、電話號碼或兩者,查詢會先執行精確比對,要求所有查詢參數符合系統連絡人記錄。如果這導致不相符,查詢會使用「盡力而為式」比對,任何一個查詢參數相符即已足夠。

如果找不到相符項目,輸入連絡人資料會顯示在連絡人卡片。如果相符,只有系統連絡人資料才會顯示,輸入連絡人資料會被捨棄。

selection

型別: Rect

Rect是使用者選取項目的矩形區域 (例如,按下按鈕),作業系統會在其周圍而不在矩形區域內顯示連絡人卡片。例如,如果應用程式使用按鈕,來顯示連絡人卡片,傳遞按鈕的 Rect,所以按鈕周圍會顯示連絡人卡片,不會將之重疊。

preferredPlacement

型別: Placement

Placement ,告訴您,連絡人卡片的偏好的位置。

備註

如用於查詢,電話號碼支援字元 0-9 和 a-z/A-Z。如果您在電話號碼中加入任何其他字元,當您查詢該連絡人時,會忽略這些字元。

需求

支援的最小用戶端

Windows 8.1

支援的最小伺服器

Windows Server 2012 R2

命名空間

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

Metadata

Windows.winmd

請參閱

ContactManager
IContactManagerInterop::ShowContactCardForWindow
ShowContactCard(Contact, Rect)

 

 

顯示:
© 2015 Microsoft