IVsHierarchyDirectionalDropDataTarget::DropArea Method (IDataObject^, UInt32, UInt32, UInt32, UInt32)
Informs the hierarchy that data has been dropped on an area.
Assembly: Microsoft.VisualStudio.Shell.Interop.11.0 (in Microsoft.VisualStudio.Shell.Interop.11.0.dll)
int DropArea( IDataObject^ pDataObject, unsigned int grfKeyState, unsigned int itemid, unsigned int area, unsigned int% pdwEffect )
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::Int32If the method succeeds, it returns S_OK. If it fails, it returns an error code.
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. |