IDirectManipulationViewport::ActivateConfiguration 方法 (directmanipulation.h)
设置输入交互的配置。
语法
HRESULT ActivateConfiguration(
[in] DIRECTMANIPULATION_CONFIGURATION configuration
);
参数
[in] configuration
DIRECTMANIPULATION_CONFIGURATION中的一个或多个值,用于指定视区交互配置。
返回值
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
交互配置指定操作引擎如何响应输入以及支持哪些操作。 在处理输入之前,可以使用 AddConfiguration 将任意数量的可能配置添加到视区。
应用程序可以在运行时使用 ActivateConfiguration 切换配置。
当 (不再需要某个配置,并且) 当前不处于活动状态时,可以使用 RemoveConfiguration 将其删除。
如果尚未使用 AddConfiguration 添加配置,则可以自动添加该配置,然后通过调用 ActivateConfiguration 激活。
注意 如果正在进行输入处理,此调用将失败。
成功调用此方法后,无法附加 拖放 行为对象。
示例
以下示例演示如何为水平平移配置视区。
HRESULT hr = pViewport>ActivateConfiguration(
DIRECTMANIPULATION_CONFIGURATION_INTERACTION |
DIRECTMANIPULATION_CONFIGURATION_TRANSLATION_X);
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | directmanipulation.h |