ContactManager.ShowDelayLoadedContactCard 方法

定義

命名空間:

Windows.ApplicationModel.Contacts

多載

ShowDelayLoadedContactCard(Contact, Rect, Placement)	如果連絡人不存在於使用者的連絡人資料庫中，則會顯示稍後可更新的連絡人卡片。
ShowDelayLoadedContactCard(Contact, Rect, Placement, ContactCardOptions)	如果連絡人不存在於使用者的連絡人資料庫中，則會顯示稍後可更新的連絡人卡片。

ShowDelayLoadedContactCard(Contact, Rect, Placement)

如果連絡人不存在於使用者的連絡人資料庫中，則會顯示稍後可更新的連絡人卡片。

public:
 static ContactCardDelayedDataLoader ^ ShowDelayLoadedContactCard(Contact ^ contact, Rect selection, Placement preferredPlacement);

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

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

function showDelayLoadedContactCard(contact, selection, preferredPlacement)

Public Shared Function ShowDelayLoadedContactCard (contact As Contact, selection As Rect, preferredPlacement As Placement) As ContactCardDelayedDataLoader

參數

contact

Contact

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

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

selection

Rect

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

preferredPlacement

Placement

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

傳回

ContactCardDelayedDataLoader

會傳回 ContactCardDelayedDataLoader 物件，可用來更新連絡人卡片。

屬性

OverloadAttribute

Windows 需求

應用程式功能

contactsSystem

另請參閱

• ShowDelayLoadedContactCard(Contact, Rect, Placement, ContactCardOptions)

ShowDelayLoadedContactCard(Contact, Rect, Placement, ContactCardOptions)

如果連絡人不存在於使用者的連絡人資料庫中，則會顯示稍後可更新的連絡人卡片。

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

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

[Windows.Foundation.Metadata.Overload("ShowDelayLoadedContactCardWithOptions")]
public static ContactCardDelayedDataLoader ShowDelayLoadedContactCard(Contact contact, Rect selection, Placement preferredPlacement, ContactCardOptions contactCardOptions);

function showDelayLoadedContactCard(contact, selection, preferredPlacement, contactCardOptions)

Public Shared Function ShowDelayLoadedContactCard (contact As Contact, selection As Rect, preferredPlacement As Placement, contactCardOptions As ContactCardOptions) As ContactCardDelayedDataLoader

參數

contact

Contact

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

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

selection

Rect

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

preferredPlacement

Placement

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

contactCardOptions

ContactCardOptions

指定要顯示連絡人卡片的方式，例如當您顯示迷你連絡人卡片時要啟動的索引標籤，或顯示完整連絡人卡片時要使用的標頭類型。

傳回

ContactCardDelayedDataLoader

會傳回 ContactCardDelayedDataLoader 物件，可用來更新連絡人卡片。

屬性

OverloadAttribute

Windows 需求

應用程式功能

contactsSystem

另請參閱

• ShowDelayLoadedContactCard(Contact, Rect, Placement)