Sent when the user drops a file on the window of an application that has registered itself as a recipient of dropped files.

Syntax

PostMessage(
    (HWND) hWndControl,   // handle to destination control
    (UINT) WM_DROPFILES,  // message ID
    (WPARAM) wParam,      // = (WPARAM) (HDROP) hDrop;
    (LPARAM) lParam       // = 0; not used, must be zero 
);

Parameters

hDrop

A handle to an internal structure describing the dropped files. Pass this handle DragFinish, DragQueryFile, or DragQueryPoint to retrieve information about the dropped files.

lParam

Must be zero.

Return Value

An application should return zero if it processes this message.

Remarks

The HDROP handle is declared in Shellapi.h. You must include this header in your build to use WM_DROPFILES. For further discussion of how to use drag-and-drop to transfer Shell data, see Transferring Shell Data Using Drag-and-Drop or the Clipboard.

Message Information

Header	winuser.h
Minimum operating systems	Windows NT 3.1, Windows 95

See Also

PostMessage, DragAcceptFiles