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);

要求

另请参阅

IDirectManipulationViewport