IDropTarget interface

The IDropTarget interface is one of the interfaces you implement to provide drag-and-drop operations in your application. It contains methods used in any application that can be a target for data during a drag-and-drop operation. A drop-target application is responsible for:

  • Determining the effect of the drop on the target application.
  • Incorporating any valid dropped data when the drop occurs.
  • Communicating target feedback to the source so the source application can provide appropriate visual feedback such as setting the cursor.
  • Implementing drag scrolling.
  • Registering and revoking its application windows as drop targets.

The IDropTarget interface contains methods that handle all these responsibilities except registering and revoking the application window as a drop target, for which you must call the RegisterDragDrop and the RevokeDragDrop functions.

When to implement

Implement the IDropTarget interface if you are developing an application that can act as a target for a drag-and-drop operation. The IDropTarget interface is associated with your application windows and is implemented on your window objects. Call the RegisterDragDrop function to register your window objects as drop targets.

When to use

You do not call the methods of IDropTarget directly. The DoDragDrop function calls the IDropTarget methods during the drag-and-drop operation.

For example, DoDragDrop calls IDropTarget::DragEnter when it detects the mouse has moved over a window that is registered as a drag target. After the mouse has entered a drag-target window, DoDragDrop calls IDropTarget::DragOver as the mouse moves through the window and calls IDropTarget::DragLeave if the mouse leaves the target window or if the user cancels or completes the drag-and-drop operation. DoDragDrop calls IDropTarget::Drop if the drop finally occurs.

Note  This interface is not supported for use across computer boundaries.

Members

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

Methods

The IDropTarget interface has these methods.

MethodDescription
DragEnter

Determines whether a drop can be accepted and its effect if it is accepted.

DragLeave

Causes the drop target to suspend its feedback actions.

DragOver

Provides target feedback to the user through the DoDragDrop function.

Drop

Drops the data into the target window.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleIdl.h

IDL

OleIdl.Idl

IID

IID_IDropTarget is defined as 00000122-0000-0000-C000-000000000046

See also

DoDragDrop
IDropSource
IDropSourceNotify
RegisterDragDrop
RevokeDragDrop

 

 

Community Additions

ADD
Show:
© 2014 Microsoft