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_ONLYDIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_DRAG ,则需要 DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICALDIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL 之一。

如果指定 了DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HOLD_DRAG ,则 同时需要DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICALDIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL

返回值

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

注解

可以在将行为添加到视区之前或之后设置该行为的配置。 如果在发生交互时进行了配置更改,则新配置对下一次交互生效。

在调用 IDirectManipulationDragDropBehavior::SetConfiguration 之前,不应调用 IDirectManipulationViewport::ActivateConfiguration。 这将导致意外行为。

要求

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

另请参阅

IDirectManipulationDragDropBehavior

IDirectManipulationViewport::ActivateConfiguration