|
IDropTarget
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 provide all these responsibilities except
registering and revoking the application window as a drop target.
When to Implement
Implement the IDropTarget interface if you are developing a container or server application that can
act as a target for a drag-and-drop operation. The IDropTarget interface is associated with your application windows and is instantiated
whenever the window is registered as a target for dropped data. You must call the RegisterDragDrop function and the RevokeDragDrop function to register and remove your application's windows as drop targets.
When to Use
The DoDragDrop function calls your IDropTarget methods within a loop 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. Once 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 when the drop finally occurs if it occurs at all.
Methods in Vtable Order
IDropTarget Methods
| Description
| DragEnter
| Determines whether a drop can be accepted and its effect if it is accepted.
| DragOver
| Provides target feedback to the user through the DoDragDrop function.
| DragLeave
| Causes the drop target to suspend its feedback actions.
|
Drop
| Drops the data into the target window.
|
See Also
DoDragDrop, IDropSource, RegisterDragDrop, RevokeDragDrop
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
