CWnd::OnQueryDragIcon

Syntax

afx_msg HCURSOR OnQueryDragIcon();

Remarks

Called by a minimized (iconic) CWnd if it is about to be dragged by the user and it does not have an icon defined for its class. The system makes this call to obtain the cursor to display while the user drags the minimized window.

If an application returns an icon handle, the system converts the icon to a black-and-white cursor.

If an application returns a handle, the handle must identify a monochrome cursor or icon compatible with the display driver's resolution. The application can call the CWinApp::LoadCursor or CWinApp::LoadIcon member functions to load a cursor or icon from the resources in its executable file and to obtain this handle.

This message-handler member function calls the Default member function. Override this member function in your derived class to handle the WM_QUERYDRAGICON message.

Return Value

Returns a cursor or icon handle. If NULL is returned, the system displays the default cursor. The default return value is NULL.

See Also

CWinApp::LoadCursor, CWinApp::LoadIcon, WM_QUERYDRAGICON, CWnd::Default