共用方式為


ContactManager.ShowContactCard 方法

定義

多載

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 ,讓連絡人卡片在按鈕周圍顯示,而不會重迭。

屬性

Windows 需求

應用程式功能
contactsSystem

備註

注意

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

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

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

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

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

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

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

另請參閱

適用於

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

屬性

Windows 需求

應用程式功能
contactsSystem

備註

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

另請參閱

適用於

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

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

屬性

Windows 需求

應用程式功能
contactsSystem

備註

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

另請參閱

適用於