DwmShowContact 函数 (dwmapi.h)

由应用或框架调用以指定视觉反馈类型来绘制以响应特定触摸或笔接触。

语法

HRESULT DwmShowContact(
  [in] DWORD           dwPointerID,
  [in] DWM_SHOWCONTACT eShowContact
);

参数

[in] dwPointerID

联系人的指针 ID。 检测到每个触摸或笔接触时,都会获得唯一 ID。

[in] eShowContact

DWM 应为此联系人显示的以下一个或多个DWM_SHOWCONTACT可视化效果。

DWMSC_NONE (0x00000000)

不应在响应联系人时显示视觉反馈。

DWMSC_DOWN(0x00000001)

显示“联系人关闭”动画,例如在按钮按下时使用。

DWMSC_UP(0x00000002)

显示“联系向上”动画,例如将在按钮释放中使用。

DWMSC_DRAG(0x00000004)

拖动触摸或笔选择的 UI 元素时,显示“联系人拖动”动画。

DWMSC_HOLD(0x00000008)

按住联系人时显示视觉对象,例如按住按钮。

DWMSC_PENBARREL(0x00000010)

按下笔桶按钮时显示笔桶视觉对象。

DWMSC_ALL(0xFFFFFFFF)

如果为其调用,则显示任何动画。

返回值

如果 dwPointerID 与屏幕上当前存在的联系人不匹配,此函数将返回E_INVALIDARG;否则,它将返回S_OK。

言论

在 UI 线程上调用此函数是安全的。

要求

要求 价值
最低支持的客户端 Windows 8 [仅限桌面应用]
支持的最低服务器 Windows Server 2012 [仅限桌面应用]
目标平台 窗户
标头 dwmapi.h
Dwmapi.lib
DLL Dwmapi.dll