ContactManager.ShowContactCard 方法

定義

命名空間:

Windows.ApplicationModel.Contacts

多載

ShowContactCard(Contact, Rect)	查詢使用者的連絡人作業系統，並在連絡人卡片中顯示連絡人資料。
ShowContactCard(Contact, Rect, Placement)	查詢使用者的連絡人作業系統，並在連絡人卡片中顯示連絡人資料。
ShowContactCard(Contact, Rect, Placement, ContactCardOptions)	顯示具有指定參數的連絡人卡片。

ShowContactCard(Contact, Rect)

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

public:
 static void ShowContactCard(Contact ^ contact, Rect selection);

/// [Windows.Foundation.Metadata.Overload("ShowContactCard")]
 static void ShowContactCard(Contact const& contact, Rect const& selection);

[Windows.Foundation.Metadata.Overload("ShowContactCard")]
public static void ShowContactCard(Contact contact, Rect selection);

function showContactCard(contact, selection)

Public Shared Sub ShowContactCard (contact As Contact, selection As Rect)

參數

contact

Contact

物件，代表應用程式想要顯示連絡人卡片的連絡人。連絡人必須至少包含電話清單中的識別碼、電子郵件或電話號碼，才能查詢使用者的連絡人資料庫，以擷取要顯示的相符連絡人。 識別碼 的優先順序較高，可供查詢。 如果 識別碼 相符，則會忽略其餘查詢參數以供比對之用。 如果 識別碼 找不到相符專案，查詢會使用其餘的查詢參數。 電子郵件 和 手機 的比對優先順序相等。 如果提供多個電子郵件地址或電話號碼或兩者，查詢會先執行完全相符，要求所有查詢參數符合系統連絡人記錄。 如果此結果不相符，查詢會使用「最佳努力」比對，其中任何查詢參數的相符專案就已足夠。

如果沒有相符專案，輸入連絡人中的資料會顯示在連絡人卡片中。 如果發生相符專案，則只會顯示系統連絡人資料，並捨棄輸入連絡人中的資料。

selection

Rect

Rect是使用者選取範圍 (矩形區域，例如按下按鈕) ，作業系統會在其中顯示連絡人卡片，而不是在該矩形區域內。 例如，如果應用程式使用按鈕來顯示連絡人卡片，請傳遞按鈕的 Rect ，讓連絡人卡片在按鈕周圍顯示，而不會重迭。

屬性

OverloadAttribute

Windows 需求

應用程式功能

contactsSystem

備註

注意

來源應用程式必須在前景執行，才能呼叫這個方法。 在背景中執行的應用程式會在呼叫此方法時收到「拒絕存取」例外狀況。

大部分的一般作業都會導致顯示 UI。

• 如果要求的連絡人有一個完全相符的專案： 顯示連絡人卡片 UI，其中包含來自作業系統中連絡人存放區的資訊。
• 如果有多個相符專案： 顯示第一個相符連絡人的連絡人卡片 UI。
• 如果沒有相符專案： 顯示連絡人卡片 UI，其中連絡人資訊來自輸入 連絡人 物件。

如果發生錯誤，例如 連絡人 參數的輸入無效，則不會顯示任何 UI。

為了查詢目的，電話號碼支援字元 0-9 和 a-z/A-Z。 如果您將任何其他字元放在電話號碼中，當您查詢連絡人時，就會忽略這些字元。

如需如何管理連絡人的詳細資訊，請參閱 連絡人和行事曆。

為了查詢目的，電話號碼支援字元 0-9 和 a-z/A-Z。 如果您將任何其他字元放在電話號碼中，當您查詢連絡人時，就會忽略這些字元。

另請參閱

• ShowContactCard(Contact, Rect, Placement)

ShowContactCard(Contact, Rect, Placement)

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

public:
 static void ShowContactCard(Contact ^ contact, Rect selection, Placement preferredPlacement);

/// [Windows.Foundation.Metadata.Overload("ShowContactCardWithPlacement")]
 static void ShowContactCard(Contact const& contact, Rect const& selection, Placement const& preferredPlacement);

[Windows.Foundation.Metadata.Overload("ShowContactCardWithPlacement")]
public static void ShowContactCard(Contact contact, Rect selection, Placement preferredPlacement);

function showContactCard(contact, selection, preferredPlacement)

Public Shared Sub ShowContactCard (contact As Contact, selection As Rect, preferredPlacement As Placement)

參數

contact

Contact

物件，代表應用程式想要顯示連絡人卡片的連絡人。連絡人必須至少包含電話清單中的識別碼、電子郵件或電話號碼，才能查詢使用者的連絡人資料庫，以擷取要顯示的相符連絡人。 識別碼 的優先順序較高，可供查詢。 如果 識別碼 相符，則會忽略其餘查詢參數以供比對之用。 如果 識別碼 找不到相符專案，查詢會使用其餘的查詢參數。 電子郵件 和 手機 的比對優先順序相等。 如果提供多個電子郵件地址或電話號碼或兩者，查詢會先執行完全相符，要求所有查詢參數符合系統連絡人記錄。 如果此結果不相符，查詢會使用「最佳努力」比對，其中任何查詢參數的相符專案就已足夠。

如果沒有相符專案，輸入連絡人中的資料會顯示在連絡人卡片中。 如果發生相符專案，則只會顯示系統連絡人資料，並捨棄輸入連絡人中的資料。

selection

Rect

Rect是使用者選取範圍 (矩形區域，例如按下按鈕) ，作業系統會在其中顯示連絡人卡片，而不是在該矩形區域內。 例如，如果應用程式使用按鈕來顯示連絡人卡片，請傳遞按鈕的 Rect ，讓連絡人卡片在按鈕周圍顯示，而不會重迭。

preferredPlacement

Placement

描述連絡人卡片慣用位置的 Placement 。

屬性

OverloadAttribute

Windows 需求

應用程式功能

contactsSystem

備註

請參閱此多載的備註一節： ShowContactCard。

另請參閱

• ShowContactCard(Contact, Rect)
• 連絡人管理員 API 範例
• IContactManagerInterop.ShowContactCardForWindow

ShowContactCard(Contact, Rect, Placement, ContactCardOptions)

顯示具有指定參數的連絡人卡片。

public:
 static void ShowContactCard(Contact ^ contact, Rect selection, Placement preferredPlacement, ContactCardOptions ^ contactCardOptions);

/// [Windows.Foundation.Metadata.Overload("ShowContactCardWithOptions")]
 static void ShowContactCard(Contact const& contact, Rect const& selection, Placement const& preferredPlacement, ContactCardOptions const& contactCardOptions);

[Windows.Foundation.Metadata.Overload("ShowContactCardWithOptions")]
public static void ShowContactCard(Contact contact, Rect selection, Placement preferredPlacement, ContactCardOptions contactCardOptions);

function showContactCard(contact, selection, preferredPlacement, contactCardOptions)

Public Shared Sub ShowContactCard (contact As Contact, selection As Rect, preferredPlacement As Placement, contactCardOptions As ContactCardOptions)

參數

contact

Contact

物件，代表應用程式想要顯示連絡人卡片的連絡人。連絡人必須至少包含電話清單中的識別碼、電子郵件或電話號碼，才能查詢使用者的連絡人資料庫，以擷取要顯示的相符連絡人。 識別碼 的優先順序較高，可供查詢。 如果 識別碼 相符，則會忽略其餘查詢參數以供比對之用。 如果 識別碼 找不到相符專案，查詢會使用其餘的查詢參數。 電子郵件 和 手機 的比對優先順序相等。 如果提供多個電子郵件地址或電話號碼或兩者，查詢會先執行完全相符，要求所有查詢參數符合系統連絡人記錄。 如果此結果不相符，查詢會使用「最佳努力」比對，其中任何查詢參數的相符專案就已足夠。

如果沒有相符專案，輸入連絡人中的資料會顯示在連絡人卡片中。 如果發生相符專案，則只會顯示系統連絡人資料，並捨棄輸入連絡人中的資料。

selection

Rect

Rect是使用者選取範圍 (矩形區域，例如按下按鈕) ，作業系統會在其中顯示連絡人卡片，而不是在該矩形區域內。 例如，如果應用程式使用按鈕來顯示連絡人卡片，請傳遞按鈕的 Rect ，讓連絡人卡片在按鈕周圍顯示，而不會重迭。

preferredPlacement

Placement

描述連絡人卡片慣用位置的 Placement 。

contactCardOptions

ContactCardOptions

指定如何顯示連絡人卡片，例如顯示迷你連絡人卡片時要啟動的索引標籤。

屬性

OverloadAttribute

Windows 需求

應用程式功能

contactsSystem

備註

請參閱此多載的備註一節： ShowContactCard。

另請參閱

• ShowContactCard(Contact, Rect)
• ShowContactCard(Contact, Rect, Placement)