Export (0) Print
Expand All

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()]
[GuidAttribute("5AA5B118-B3D4-40C5-8739-231CE192850C")]
public interface IVsHierarchyDropDataTarget

The IVsHierarchyDropDataTarget type exposes the following members.

  NameDescription
Public methodDragEnterCalled as soon as the mouse drags an item over a new hierarchy or hierarchy window.
Public methodDragLeaveCalled 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.
Public methodDragOverCalled when one or more items are dragged over the target hierarchy or hierarchy window.
Public methodDropCalled when one or more items are dropped into the target hierarchy or hierarchy window when the mouse button is released.
Top

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.

Show:
© 2014 Microsoft