nn-shobjidl_core-idroptargethelper.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NN:shobjidl_core.IDropTargetHelper	IDropTargetHelper (shobjidl_core.h)	Exposes methods that allow drop targets to display a drag image while the image is over the target window.	IDropTargetHelper IDropTargetHelper interface [Windows Shell] IDropTargetHelper interface [Windows Shell] described _win32_IDropTargetHelper shell.IDropTargetHelper shobjidl_core/IDropTargetHelper	shell\IDropTargetHelper.htm	shell	b1ddbf7e-edf3-48fb-8983-ae39cb7bb4b0	12/05/2018	IDropTargetHelper, IDropTargetHelper interface [Windows Shell], IDropTargetHelper interface [Windows Shell],described, _win32_IDropTargetHelper, shell.IDropTargetHelper, shobjidl_core/IDropTargetHelper	shobjidl_core.h	Shobjidl.h	Windows	Windows 2000 Professional, Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]					Shobjidl.idl						Shell32.dll (version 5.0 or later)		Windows			19H1	IDropTargetHelper shobjidl_core/IDropTargetHelper	c++	APIRef kbSyntax	COM	Shell32.dll	IDropTargetHelper

IDropTargetHelper interface

-description

Exposes methods that allow drop targets to display a drag image while the image is over the target window.

-inheritance

The IDropTargetHelper interface inherits from the IUnknown interface. IDropTargetHelper also has these types of members:

-remarks

This interface is exposed by the Shell's drag-image manager. It is not implemented by applications.

This interface is used by drop targets to enable the drag-image manager to display the drag image while the image is over the target window. The IDragSourceHelper and IDropTargetHelper interfaces are exposed by the drag-image manager object to allow the IDropTarget interface to use custom drag images. To use either of these interfaces, you must create an in-process server drag-image manager object by calling CoCreateInstance with a class identifier (CLSID) of CLSID_DragDropHelper. Get interface pointers using standard Component Object Model (COM) procedures.

Four of the IDropTargetHelper methods correspond to the four IDropTarget methods. When you implement IDropTarget, each of its methods should call the corresponding IDropTargetHelper method to pass the information to the drag-image manager. The fifth IDropTargetHelper method notifies the drag-image manager to show or hide the drag image. This method is used when dragging over a target window in a low color-depth video mode. It allows the target to hide the drag image while it is painting the window.

Note   The drag-and-drop helper object calls IDataObject::SetData to load private formats—used for cross-process support—into the data object. It later retrieves these formats by calling IDataObject::GetData. To support the drag-and-drop helper object, the data object's SetData and GetData implementations must be able to accept and return arbitrary private formats.

 

For further discussion of Shell drag-and-drop operations, see Transferring Shell Data Using Drag-and-Drop or the Clipboard.

Note   Prior to Windows Vista this interface was declared in Shlobj.h.

 

-see-also

IDragSourceHelper

Shell Data Object