|
IDropTarget::Drop
Incorporates the source data into the target window, removes target feedback,
and releases the data object.
HRESULT Drop(
IDataObject * pDataObject,
| //IDataObject interface for the source data
| DWORD grfKeyState,
| //Current state of keyboard modifier keys
| POINTL pt,
| //Current cursor coordinates
| DWORD * pdwEffect
| //Effect of the drag-and-drop operation
| );
|
|
Parameters
pDataObject
[in] Points to the data object being transferred in the drag-and-drop
operation. The data is represented in the IDataObject interface.
grfKeyState
[in] Identifies the current state of the keyboard modifier keys on the
keyboard. Valid values can be a combination of any of the flags MK_CONTROL, MK_SHIFT,
MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON, and MK_RBUTTON.
pt
[in] Points to the current cursor coordinates in the coordinate space of the
drop target window.
pdwEffect
[in, out] Specifies the current effect flag. Valid values are from the
enumeration DROPEFFECT.
Return Values
S_OK
The function completed its tasks successfully.
E_OUTOFMEMORY
Out of memory.
E_INVALIDARG
One or more arguments are invalid.
E_UNEXPECTED
An unexpected error occurred.
Comments
The DoDragDrop function calls this method when the user completes the drag-and-drop
operation.
In IDropTarget::Drop, you must incorporate the data object into the target. You can use the
formats available in IDataObject along with the current state of the modifier keys to determine how the data
is to be incorporated. This can be, for example, linking the data or embedding
it.
In addition to incorporating the data, you must also clean up as you do in the IDropTarget::DragLeave method:
- Remove any target feedback that is currently displayed.
- Release any references to the data object.
You also pass the effect of this operation back to the source application
through DoDragDrop, so the source application can clean up after the drag-and-drop operation is
complete:
- Remove any source feedback that is currently displaying.
- Make any necessary changes to the data, for example, removing the data if the
operation was a move.
See Also
DoDragDrop, IDropSource, IDropTarget, RegisterDragDrop, RevokeDragDrop
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
