IVsHierarchyDropDataSource2::GetDropInfo Method (UInt32, IDataObject^, IDropSource^)

Visual Studio 2015

Returns information about one or more of the dragged items.

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

Syntax

C++

int GetDropInfo(
	[OutAttribute] unsigned int% pdwOKEffects,
	[OutAttribute] IDataObject^% ppDataObject,
	[OutAttribute] IDropSource^% ppDropSource
)

Parameters

pdwOKEffects: Type: System::UInt32
[out] Pointer to a DWORD value indicating the effect of the drop: DROPEFFECT_COPY, DROPEFFECT_LINK, or DROPEFFECT_MOVE. The values are mutually exclusive and cannot be combined.

ppDataObject: Type: Microsoft.VisualStudio.OLE.Interop::IDataObject^
[out] Pointer to the IDataObject interface of the dragged item. This data object contains the data transferred in the drag-and-drop operation. If the drop occurs, then this data object (item) is incorporated in the target hierarchy or hierarchy window.

ppDropSource: Type: Microsoft.VisualStudio.Shell.Interop::IDropSource^
[out] Pointer to the IDropSource interface of the dragged item.

Return Value

Type: System::Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Implements

IVsHierarchyDropDataSource::GetDropInfo(UInt32, IDataObject^, IDropSource^)

Remarks

COM Signature

From vsshell.idl:

C++

HRESULT IVsHierarchyDropDataSource2::GetDropInfo(
   [out]DWORD* pdwOKEffects,
   [out]IDataObject** ppDataObject,
   [out]IDropSource** ppDropSource
);

This method changes the cursor based on the item that the source data is dragged over. The cursor values are determined by OLE. For example, for an effect of DROP_NONE, a circle with a line through it is displayed; for a move, a box with an arrow is displayed; and for a copy, the move icon with a plus sign is displayed.