IDirectManipulationViewport：：AddConfiguration 方法 (directmanipulation.h)

为视区添加交互配置。

语法

HRESULT AddConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

[in] configuration

DIRECTMANIPULATION_CONFIGURATION的值之一，用于指定视区交互配置。

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

交互配置指定操作引擎如何响应输入以及支持哪些操作。在处理输入之前，可以使用 AddConfiguration 将任意数量的可能配置添加到视区。

应用程序可以在运行时使用 ActivateConfiguration 切换配置。

当 (不再需要某个配置，并且) 当前不处于活动状态时，可以使用 RemoveConfiguration 将其删除。

如果尚未使用 AddConfiguration 添加配置，则可以自动添加该配置，然后通过调用 ActivateConfiguration 激活。

注意如果正在进行输入处理，此调用将失败。

如果指定了拖放行为，此方法将失败。

成功调用此方法后，无法附加拖放行为对象。

在添加现有拖放行为后，无法添加其他拖放行为。

此方法旨在允许应用程序切换预添加的配置，因为发生操作时无法更改配置。在大多数情况下，最好使用 ActivateConfiguration 更新配置。