win32clipboard.SetClipboardViewer

PyHANDLE = SetClipboardViewer(hWndNewViewer)

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.

Parameters

hWndNewViewer : PyHANDLE

Integer handle to the window to be added to the clipboard chain.

Comments

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 theWM_DESTROY message.

Win32 API References

Search for SetClipboardViewer at msdn, google or google groups.

Return Value

Returns a handle to the next window in chain, or None if no other viewer exists.

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, win32api.error is raised with the GetLastError info.