通过

IVsHierarchyDropDataTarget.DragEnter 方法

  • 项目

调用，当鼠标拖动到新的层次结构或层次结构窗口中的项。

命名空间：  Microsoft.VisualStudio.Shell.Interop
程序集：  Microsoft.VisualStudio.Shell.Interop（在 Microsoft.VisualStudio.Shell.Interop.dll 中）

语法

声明
Function DragEnter ( _
    pDataObject As IDataObject, _
    grfKeyState As UInteger, _
    itemid As UInteger, _
    <OutAttribute> ByRef pdwEffect As UInteger _
) As Integer

int DragEnter(
    IDataObject pDataObject,
    uint grfKeyState,
    uint itemid,
    out uint pdwEffect
)

参数

  • grfKeyState
    类型：System.UInt32
    [in] 键盘和鼠标修改键的当前状态。有效值如下表所示。使用或运算符，这些值可以按位组合。
    [1|1] 十六进制
    [1|2] 值
    [1|3]“描述”
    [2|1 个] 0x0001
    [2|2] MK_LBUTTON
    [2|3] 鼠标左键单击。
    [3|1 个] 0x0002
    [3|2] MK_RBUTTON
    [3|3] 鼠标右键单击。
    [4|1 个] 0x0004
    [4|2] MK_SHIFT
    [4|3] 移位 按下了键。
    [5|1 个] 0x0008
    [5|2] MK_CONTROL
    [5|3] 控件 按下了键。
    [6|1 个 0x0010]
    [6|2] MK_MBUTTON
    [6|3] 元单击鼠标按钮。
    [7|1 个 0x0020]
    [7|2] MK_ALT
    [7| ALT ] ALT 按下了键。
  • itemid
    类型：System.UInt32
    [in] 当前拖动的项的项 ID。有关 itemid 值列表，请参见 VSITEMID。
  • pdwEffect
    类型：System.UInt32%
    [in, out] 在项，对 IVsHierarchy 对象的 pdwEffect 参数的指针的值，标识该层次结构支持的任何效果。在返回，必须包含指示放置操作的结果中的有效标志。有关更多信息，请参见 IVsHierarchyDropDataSource2。

返回值

类型：System.Int32
如果方法成功，则返回 S_OK。如果失败，它会返回一个错误代码。

备注

COM 签名

从 vsshell.idl:

HRESULT IVsHierarchyDropDataTarget::DragEnter(
   [in]IDataObject * pDataObject,
   [in]DWORD grfKeyState,
   [in]VSITEMID itemid,
   [in, out]DWORD * pdwEffect
);

DragEnter 方法，则当项目首次进入层次结构 " 窗口时，或者当该项拖动到新的层次结构中。 在调用 DragEnter 方法后，该层次结构 DragOver 调用方法，直到该项目将新的层次结构或层次结构 " 窗口，，这时它将调用 DragLeave 或 Drop 方法。

DragEnter 方法在键盘键和鼠标按钮的状态也将 (在一个或多个是否按下)。

放置效果。 pdwEffect 参数包括并描述事件与拖放操作。 下表显示可能的 pdwEffect 值及其说明:

备注

使用或运算符，这些效果是排他的，不能按位组合。

角色名称

值 1

说明

DROPEFFECT_NONE

0

放置目标 (层次结构 " 窗口) 无法接受数据。 放置不允许。

DROPEFFECT_COPY

1

删除的项在源保持，并且其副本添加到目标。

DROPEFFECT_MOVE

2

删除的项目已添加到目标。 该项从源中移除，并且其存储中删除。

DROPEFFECT_LINK

4

源项目的链接添加到目标。 应从源然后移除源项目，但存储应该保持，以便该链接不是中断。 链接是一个特例移动。

pwdEffects 参数的值是从 DragDropEffects 枚举中采用。

.NET Framework 安全性

请参见

参考

IVsHierarchyDropDataTarget 接口

Microsoft.VisualStudio.Shell.Interop 命名空间