win32clipboard.GetClipboardOwner

int = GetClipboardOwner()

The GetClipboardOwner function retrieves the window handle of the current owner of the clipboard.

Comments

The clipboard can still contain data even if the clipboard is not currently owned.
In general, the clipboard owner is the window that last placed data in clipboard. The EmptyClipboard function assigns clipboard ownership.

Example

This example shows how to handle the fact an owner may be null while still handing real exceptions:

try:

    owner = win32clipboard.GetClipboardOwner()

except win32api.error as e:

    if e.winerror != 0:

       raise

    owner = None

Win32 API References

Search for GetClipboardOwner at msdn, google or google groups.

Return Value

If the function succeeds, the return value is the handle of the window that owns the clipboard. If the function fails, win32api.error is raised with the GetLastError info.
If there is no current owner, the function will fail with a `win32api.error` with `winerror` set to 0 - in other words, the function will never return None. This behaviour was not intentional but is being retained for backwards compatibility.