IDirectManipulationDragDropBehavior::SetConfiguration 方法 (directmanipulation.h)
设置此行为附加到的视区的拖放交互的配置。
语法
HRESULT SetConfiguration(
[in] DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION configuration
);
参数
[in] configuration
来自DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION的值的组合。
要使配置有效, 配置 必须正好包含以下三个值之一:
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_ONLY
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_DRAG
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HOLD_DRAG
如果指定 了DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_ONLY 或 DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_DRAG ,则需要 DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICAL 或 DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL 之一。
如果指定 了DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HOLD_DRAG ,则 同时需要DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICAL 和 DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL 。
返回值
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
可以在将行为添加到视区之前或之后设置该行为的配置。 如果在发生交互时进行了配置更改,则新配置对下一次交互生效。
在调用 IDirectManipulationDragDropBehavior::SetConfiguration 之前,不应调用 IDirectManipulationViewport::ActivateConfiguration。 这将导致意外行为。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8.1 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | directmanipulation.h |