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	用户

构造函数

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开始不再可用。

另请参阅

• 联系人选取器应用示例
• 我的人员通知示例