CWnd::SetClipboardViewer

Syntax

HWND SetClipboardViewer();

Remarks

Adds CWnd to the Clipboard-viewer chain and returns a handle to the next window in the chain.

A CWnd that is part of the Clipboard-viewer chain must respond to WM_DRAWCLIPBOARD, WM_CHANGECBCHAIN, and WM_DESTROY messages, and pass the message to the next window in the chain.

This member function sends a WM_DRAWCLIPBOARD message to the CWnd. Since the handle to the next window in the Clipboard-viewer chain has not yet been returned, the application should be careful to not pass on the WM_DRAWCLIPBOARD message that it receives during the call to SetClipboardViewer.

If an application wishes to remove itself from the Clipboard-viewer chain, it must call the ChangeClipboardChain member function.

Return Value

A handle to the next window in the Clipboard-viewer chain. This handle should be saved in static memory and used to pass on Clipboard-viewer chain messages.

See Also

CWnd::ChangeClipboardChain, ::SetClipboardViewer