ContactManager.ShowContactCard(Contact, Rect, Placement) | showContactCard(Contact, Rect, Placement) Method

在操作系统中查询用户联系人并在联系人卡片中显示联系人数据。

语法


Windows.ApplicationModel.Contacts.ContactManager.showContactCard(contact, selection, preferredPlacement);

参数

contact

类型: Contact

表示联系人的对象,应用程序希望显示该联系人的联系人卡片。

contact 必须至少包含 IdEmailsPhones 列表中的一个电话号码,才能查询用户的联系人数据库以检索并显示匹配的联系人。Id 具有较高的查询优先级。如果 Id 匹配,则其余查询参数将为了匹配的目而被忽略。如果 Id 找不到匹配项,则查询使用其余查询参数。EmailsPhones 具有相等的匹配优先级。如果提供多个电子邮件地址和/或电话号码,则查询首先执行完全匹配,要求所有查询参数与系统联系人记录匹配。如果这会导致没有匹配项,则查询会使用“尽力”匹配,这种情况下任何查询参数的一个匹配项就足够了。

如果不发生匹配,则输入联系人中的数据会显示在联系人卡片中。如果出现匹配项,则只显示系统联系人数据,输入联系人中的数据会被丢弃。

selection

类型: Rect

Rect 是用户选中的矩形区域(例如,按某个按钮。),操作系统将在此矩形区域周围显示联系人卡片,而不是在其内部显示。例如,如果应用程序使用按钮显示联系人卡片,则传递按钮的 Rect 以便联系人卡片在此按钮的周围显示,而不会与按钮重叠。

preferredPlacement

类型: Placement

Placement 用于描述联系人卡片的首选位置。

备注

针对查询目的,电话号码支持字符 0-9 和 a-z/A-Z。如果你在电话号码中输入任何其他字符,当你查询联系人时它们会被忽略。

要求

最低支持客户端

Windows 8.1

最低支持服务器

Windows Server 2012 R2

命名空间

Windows.ApplicationModel.Contacts
Windows::ApplicationModel::Contacts [C++]

元数据

Windows.winmd

另请参见

ContactManager
IContactManagerInterop::ShowContactCardForWindow
ShowContactCard(Contact, Rect)

 

 

显示:
© 2015 Microsoft