ContactManager.ShowContactCard 方法

定义

命名空间:

Windows.ApplicationModel.Contacts

重载

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

表示应用要显示其联系人卡的联系人的 对象。联系人必须至少包含“Id”、“电子邮件”或“电话”列表中的电话号码，才能查询用户的联系人数据库，以检索要显示的匹配联系人。 ID 具有更高的查询优先级。 如果 ID 匹配，则出于匹配目的，将忽略其余查询参数。 如果 ID 找不到匹配项，则查询将使用查询参数的其余部分。 电子邮件 和 电话 具有同等的匹配优先级。 如果提供了多个电子邮件地址或电话号码或两者，则查询首先执行完全匹配，要求所有查询参数匹配系统联系人记录。 如果这导致不匹配，则查询将使用“尽力而为”的匹配，其中任何查询参数的匹配就足够了。

如果没有匹配项，则输入触点中的数据将显示在联系人卡中。 如果发生匹配，则仅显示系统接触数据，输入触点中的数据将被丢弃。

selection

Rect

Rect 是用户选择的矩形区域， (例如，按下按钮) ，操作系统围绕该按钮显示联系人卡，而不是在该矩形区域内。 例如，如果应用使用按钮显示联系人卡，则传递按钮的 Rect，使联系人卡显示在按钮周围，而不是重叠。

属性

OverloadAttribute

Windows 要求

应用功能	contactsSystem

注解

注意

源应用必须在前台运行才能调用此方法。 如果在后台运行的应用调用此方法，则会收到“拒绝访问”异常。

大多数典型操作都会导致显示 UI。

• 如果请求的联系人有一个完全匹配项：显示联系人卡 UI，其中包含来自操作系统中联系人存储的信息。
• 如果有多个匹配项：显示找到的第一个匹配联系人的联系人卡 UI。
• 如果没有匹配项：显示联系人卡 UI，其中联系人信息来自输入联系人对象。

如果出现错误（例如 ，联系人 参数的输入无效），则不显示 UI。

出于查询目的，电话号码支持字符 0-9 和 a-z/A-Z。 如果在电话号码中放入任何其他字符，查询联系人时会忽略这些字符。

有关如何管理联系人的信息，请参阅 联系人和日历。

出于查询目的，电话号码支持字符 0-9 和 a-z/A-Z。 如果在电话号码中放入任何其他字符，查询联系人时会忽略这些字符。

另请参阅

• ShowContactCard(Contact, Rect, Placement)

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

表示应用要显示其联系人卡的联系人的 对象。联系人必须至少包含“Id”、“电子邮件”或“电话”列表中的电话号码，才能查询用户的联系人数据库，以检索要显示的匹配联系人。 ID 具有更高的查询优先级。 如果 ID 匹配，则出于匹配目的，将忽略其余查询参数。 如果 ID 找不到匹配项，则查询将使用查询参数的其余部分。 电子邮件 和 电话 具有同等的匹配优先级。 如果提供了多个电子邮件地址或电话号码或两者，则查询首先执行完全匹配，要求所有查询参数匹配系统联系人记录。 如果这导致不匹配，则查询将使用“尽力而为”的匹配，其中任何查询参数的匹配就足够了。

如果没有匹配项，则输入触点中的数据将显示在联系人卡中。 如果发生匹配，则仅显示系统接触数据，输入触点中的数据将被丢弃。

selection

Rect

Rect 是用户选择的矩形区域， (例如，按下按钮) ，操作系统围绕该按钮显示联系人卡，而不是在该矩形区域内。 例如，如果应用使用按钮显示联系人卡，则传递按钮的 Rect，使联系人卡显示在按钮周围，而不是重叠。

preferredPlacement

Placement

描述联系人卡的首选放置的位置。

属性

OverloadAttribute

Windows 要求

应用功能	contactsSystem

注解

请参阅此重载的备注部分： ShowContactCard。

另请参阅

• ShowContactCard(Contact, Rect)
• 联系人管理器 API 示例
• IContactManagerInterop.ShowContactCardForWindow

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

表示应用要显示其联系人卡的联系人的 对象。联系人必须至少包含“Id”、“电子邮件”或“电话”列表中的电话号码，才能查询用户的联系人数据库，以检索要显示的匹配联系人。 ID 具有更高的查询优先级。 如果 ID 匹配，则出于匹配目的，将忽略其余查询参数。 如果 ID 找不到匹配项，则查询将使用查询参数的其余部分。 电子邮件 和 电话 具有同等的匹配优先级。 如果提供了多个电子邮件地址或电话号码或两者，则查询首先执行完全匹配，要求所有查询参数匹配系统联系人记录。 如果这导致不匹配，则查询将使用“尽力而为”的匹配，其中任何查询参数的匹配就足够了。

如果没有匹配项，则输入触点中的数据将显示在联系人卡中。 如果发生匹配，则仅显示系统接触数据，输入触点中的数据将被丢弃。

selection

Rect

Rect 是用户选择的矩形区域， (例如，按下按钮) ，操作系统围绕该按钮显示联系人卡，而不是在该矩形区域内。 例如，如果应用使用按钮显示联系人卡，则传递按钮的 Rect，使联系人卡显示在按钮周围，而不是重叠。

preferredPlacement

Placement

描述联系人卡的首选放置的位置。

contactCardOptions

ContactCardOptions

指定如何显示联系人卡，例如在显示小型联系人卡时要启动哪个选项卡。

属性

OverloadAttribute

Windows 要求

应用功能	contactsSystem

注解

请参阅此重载的备注部分： ShowContactCard。

另请参阅

• ShowContactCard(Contact, Rect)
• ShowContactCard(Contact, Rect, Placement)