ChangeClipboardChain
The ChangeClipboardChain
function removes a specified window from the chain of clipboard viewers.
BOOL ChangeClipboardChain(
|
HWND hWndRemove, |
// handle to window
to remove |
|
HWND hWndNewNext |
// handle to next
window |
|
); |
|
Parameters
hWndRemove
Identifies
the window to be removed from the chain. The handle must have been passed to
the SetClipboardViewer
function.
hWndNewNext
Identifies
the window that follows the hWndRemove window in the clipboard viewer
chain. (This is the handle returned by SetClipboardViewer, unless the
sequence was changed in response to a WM_CHANGECBCHAIN message.)
Return Values
The return
value indicates the result of passing the WM_CHANGECBCHAIN message to the
windows in the clipboard viewer chain. Because a window in the chain typically
returns FALSE when it processes WM_CHANGECBCHAIN, the return value from ChangeClipboardChain
is typically FALSE. If there is only one window in the chain, the return value
is typically TRUE.
Remarks
The window
identified by hWndNewNext replaces the hWndRemove window in the
chain. The SetClipboardViewer function sends a WM_CHANGECBCHAIN message
to the first window in the clipboard viewer chain.
See Also