ContactPicker 類別

定義

命名空間:

Windows.ApplicationModel.Contacts

控制連絡人選擇器使用者介面的開啟方式，以及其顯示的資訊。

public ref class ContactPicker sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ContactPicker final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ContactPicker

function ContactPicker()

Public NotInheritable Class ContactPicker

繼承

Object Platform::Object IInspectable ContactPicker

屬性

ActivatableAttribute ContractVersionAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
應用程式功能	contactsSystem

備註

ContactPicker 類別可讓使用者從支援連絡人選擇器合約的任何應用程式中選取一或多個連絡人。 您可以將 ContactPicker 類別設定為只接受單一連絡人或多個連絡人。 此外，您可以要求提供連絡人資訊的應用程式會針對每個連絡人傳回整組資料，或只傳回特定欄位。

如需如何選取連絡人的詳細資訊，請參閱 選取連絡人。

版本歷程記錄

Windows 版本	SDK 版本	新增值
1703	15063	CreateForUser
1703	15063	IsSupportedAsync
1703	15063	User

建構函式

ContactPicker()

初始化 ContactPicker 類別的新實例。

屬性

CommitButtonText	設定連絡人選擇器使用者介面中確認按鈕的文字。 注意 從 Windows 10 開始，就無法再使用這個屬性。
DesiredFields	設定應用程式感興趣的連絡人欄位。 注意 從 Windows 10 開始，就無法再使用這個屬性。
DesiredFieldsWithContactFieldType	取得與連絡人連線的方式。
SelectionMode	控制連絡人選擇器是否會將連絡人顯示為完整實體或欄位集合。 注意 從 Windows 10 開始，就無法再使用這個屬性。
User	取得與ContactPicker相關聯的使用者。

方法

CreateForUser(User)	為特定使用者建立新的ContactPicker。
IsSupportedAsync()	取得布林值，指出目前平臺上是否支援連絡人選擇器。
PickContactAsync()	啟動連絡人選擇器以選取單一連絡人。
PickContactsAsync()	啟動連絡人選擇器，以選取多個連絡人。
PickMultipleContactsAsync()	啟動連絡人選擇器，以選取多個連絡人。 注意 從 Windows 10 開始，這個方法已不再提供。
PickSingleContactAsync()	啟動連絡人選擇器，以選取單一連絡人。 注意 從 Windows 10 開始，這個方法已不再提供。

另請參閱

• 連絡人選擇器應用程式範例
• 我的人員通知範例