INameSpaceTreeControlDropHandler::OnDrop 方法 (shobjidl.h)

在 drop 上调用 以按指定设置放置效果。

语法

HRESULT OnDrop(
  [in]      IShellItem      *psiOver,
  [in]      IShellItemArray *psiaData,
  [in]      int             iPosition,
  [in]      DWORD           grfKeyState,
  [in, out] DWORD           *pdwEffect
);

参数

[in] psiOver

类型: IShellItem*

指向 IShellItem 接口的指针,该接口表示鼠标光标下的项。 可选。

[in] psiaData

类型: IShellItemArray*

指向表示数据对象的 IShellItem 数组的指针。

[in] iPosition

类型: int

指定放置位置。

[in] grfKeyState

类型:DWORD

键盘修饰键的当前状态。

[in, out] pdwEffect

类型: DWORD*

指向放置效果值的指针。

返回值

类型: HRESULT

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

注解

注意 若要覆盖默认放置行为,客户端应使此方法失败;成功继续执行默认放置操作。
 

要求

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

另请参阅

IDropTarget::D rop

INameSpaceTreeControlDropHandler