IContactManagerInterop：：ShowContactCardForWindow 方法 (shobjidl_core.h)

  • 项目

在指定窗口上显示联系人的 UI。

语法

HRESULT ShowContactCardForWindow(
  [in] HWND             appWindow,
  [in] IUnknown         *contact,
  [in] const RECT       *selection,
  [in] FLYOUT_PLACEMENT preferredPlacement
);

参数

[in] appWindow

类型：HWND

从中启动联系人卡的应用的前景窗口以及关闭联系人卡时返回焦点的应用的前景窗口的 HWND。

[in] contact

类型： IUnknown*

指向 contact 对象的指针。 使用 Windows.ApplicationModel.Contacts.Contact 对象，但在此处转换为 IUnknown，因为经典 COM IDL 无法使用Windows 运行时类型。

[in] selection

类型： RECT const*

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

[in] preferredPlacement

类型： FLYOUT_PLACEMENT

描述接触卡的首选位置的FLYOUT_PLACEMENT类型的值。

值 含义
FP_DEFAULT
0
 使用默认值。
FP_ABOVE
1
 首选将触点卡放置在由 selection 参数指定的用户选择的矩形区域上方。
FP_BELOW
2
 首选将触点卡放置在由 selection 参数指定的用户选择的矩形区域下方。
FP_LEFT
3
 首选将触点卡放在由 selection 参数指定的用户选择的矩形区域的左侧。
FP_RIGHT
4
 首选将触点卡放在由 selection 参数指定的用户选择的矩形区域的右侧。

返回值

类型： HRESULT

ShowContactCardForWindow 返回：

  • S_OK是否成功显示联系人卡
  • 如果 appWindow 为 NULL、 contact 为 NULL 或 选择 为 NULL，则E_POINTER
  • E_INVALIDARG如果 contact 不是 Windows.ApplicationModel.Contacts.Contact 对象或 preferredPlacement 是无效的枚举值
其他 HRESULT 值是可能的。

要求

要求 值
最低受支持的客户端 Windows 8.1 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 R2 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h

另请参阅

IContactManagerInterop

ShowContactCardForWindow