IDirectManipulationViewport::SetInputMode 方法 (directmanipulation.h)

指定输入是否对 UI 线程可见。

语法

HRESULT SetInputMode(
  [in] DIRECTMANIPULATION_INPUT_MODE mode
);

参数

[in] mode

DIRECTMANIPULATION_INPUT_MODE中的值之

返回值

如果方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

DIRECTMANIPULATION_INPUT_MODE_AUTOMATIC是 直接操作的默认模式。

直接操作 使用驱动操作的所有输入,应用程序接收WM_POINTERCAPTURECHANGED消息。

在某些情况下,应用程序可能希望接收驱动操作的输入。 在这种情况下,设置DIRECTMANIPULATION_INPUT_MODE_MANUAL。 应用程序将接收所有输入消息,甚至 直接操作 用于驱动操作的输入。

注意 应用程序不会收到WM_POINTERCAPTURECHANGED消息。
 
使用 DIRECTMANIPULATION_INPUT_MODE_MANUAL 集调用此方法类似于调用 SetViewportOptions (DIRECTMANIPULATION_VIEWPORT_OPTIONS_INPUT) 。 但是,调用 SetViewportOptions 也会替代所有其他设置。

示例

以下示例演示如何使用此方法。

HRESULT hr = pViewport->SetInputMode(DIRECTMANIPULATION_INPUT_MODE_AUTOMATIC);

要求

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

另请参阅

IDirectManipulationViewport