SetClipboardViewer
The SetClipboardViewer
function adds the specified window to the chain of clipboard viewers. Clipboard
viewer windows receive a WM_DRAWCLIPBOARD message whenever the content of the
clipboard changes.
HWND SetClipboardViewer(
|
HWND hWndNewViewer |
// handle of
clipboard viewer window |
|
); |
|
Parameters
hWndNewViewer
Identifies
the window to be added to the clipboard chain.
Return Values
If the
function succeeds, the return value identifies the next window in the clipboard
viewer chain. If an error occurs or there are no other windows in the clipboard
viewer chain, the return value is NULL. To get extended error information, call
GetLastError.
Remarks
The windows
that are part of the clipboard viewer chain, called clipboard viewer windows,
must process the clipboard messages WM_CHANGECBCHAIN and WM_DRAWCLIPBOARD. Each
clipboard viewer window calls the SendMessage function to pass these
messages to the next window in the clipboard viewer chain.
A clipboard
viewer window must eventually remove itself from the clipboard viewer chain by
calling the ChangeClipboardChain function for example, in response to the WM_DESTROY message.
See Also