Share via


IVsHierarchyDirectionalDropDataTarget.DropArea Method

Informs the hierarchy that data has been dropped on an area.

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

Syntax

'Declaration
Function DropArea ( _
    pDataObject As IDataObject, _
    grfKeyState As UInteger, _
    itemid As UInteger, _
    area As UInteger, _
    <OutAttribute> ByRef pdwEffect As UInteger _
) As Integer
int DropArea(
    IDataObject pDataObject,
    uint grfKeyState,
    uint itemid,
    uint area,
    out uint pdwEffect
)
int DropArea(
    [InAttribute] IDataObject^ pDataObject, 
    [InAttribute] unsigned int grfKeyState, 
    [InAttribute] unsigned int itemid, 
    [InAttribute] unsigned int area, 
    [InAttribute] [OutAttribute] unsigned int% pdwEffect
)
abstract DropArea : 
        pDataObject:IDataObject * 
        grfKeyState:uint32 * 
        itemid:uint32 * 
        area:uint32 * 
        pdwEffect:uint32 byref -> int
function DropArea(
    pDataObject : IDataObject, 
    grfKeyState : uint, 
    itemid : uint, 
    area : uint, 
    pdwEffect : uint
) : int

Parameters

  • pDataObject
    Type: Microsoft.VisualStudio.OLE.Interop.IDataObject

    [in] The item being dragged. This data object contains the data being transferred in the drag-and-drop operation. If the drop occurs, then this data object (item) is incorporated into the target hierarchy or hierarchy window.

  • grfKeyState
    Type: System.UInt32

    [in] Current state of the keyboard and the mouse modifier keys.

  • itemid
    Type: System.UInt32

    [in] Item identifier of the drop data target over which the item is being dragged. For a list of itemid values, see VSConstants.VSITEMID.

  • area
    Type: System.UInt32

    [in] The area over which the item is to be dropped.

  • pdwEffect
    Type: System.UInt32%

    [in, out] Visual effects associated with the drag-and drop-operation, such as a cursor, bitmap, and so on. The value of dwEffects passed to the source object through the OnDropNotify method is the value of pdwEffects returned by this method.

Return Value

Type: System.Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

Valid values for grfKeyState are shown in the following table. These values can be combined using a bitwise OR operator.

Hex

Value

Description

0x0001

MK_LBUTTON

Left mouse button is clicked.

0x0002

MK_RBUTTON

Right mouse button is clicked.

0x0004

MK_SHIFT

SHIFT key is pressed.

0x0008

MK_CONTROL

CONTROL key is pressed.

0x0010

MK_MBUTTON

Middle mouse button is clicked.

0x0020

MK_ALT

ALT key is pressed.

.NET Framework Security

See Also

Reference

IVsHierarchyDirectionalDropDataTarget Interface

Microsoft.VisualStudio.Shell.Interop Namespace