IVsHierarchyDropDataTarget Interface

 

Provides information about a dragged item in relation to its drop target during a drag-and-drop operation within a hierarchy window.

Namespace:   Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

[InterfaceTypeAttribute(1)]
[GuidAttribute("5AA5B118-B3D4-40C5-8739-231CE192850C")]
public interface IVsHierarchyDropDataTarget

NameDescription
System_CAPS_pubmethodDragEnter(IDataObject, UInt32, UInt32, UInt32)

Called as soon as the mouse drags an item over a new hierarchy or hierarchy window.

System_CAPS_pubmethodDragLeave()

Called when one or more items are dragged out of the hierarchy or hierarchy window, or when the drag-and-drop operation is cancelled or completed.

System_CAPS_pubmethodDragOver(UInt32, UInt32, UInt32)

Called when one or more items are dragged over the target hierarchy or hierarchy window.

System_CAPS_pubmethodDrop(IDataObject, UInt32, UInt32, UInt32)

Called when one or more items are dropped into the target hierarchy or hierarchy window when the mouse button is released.

In every drag-and-drop operation within a hierarchy, information is required about the item that is being dragged and where it is being dropped. IVsHierarchyDropDataTarget provides the information about where the item is being dropped. The IVsHierarchyDropDataSource interface provides information about the item being dragged.

During the drag-and-drop operation, the DragEnter method is called when the hierarchy detects that the mouse has moved over a new hierarchy or a new hierarchy window. The hierarchy then calls the DragOver method as the mouse moves over the hierarchy or hierarchy window and the DragLeave method if the mouse leaves the hierarchy or hierarchy window or if you cancel or complete the drag-and-drop operation. The hierarchy calls the Drop method when the drop finally occurs.

Notes to Implementers:

Hierarchies are implemented in VSPackages to display projects. Use this interface within your hierarchy implementation to include drag-and-drop behavior within and between hierarchies.

Return to top
Show: