WinQueryClipbrdViewer: Difference between revisions

Latest revision as of 19:12, 10 April 2025

This function obtains any current clipboard viewer window.

WinQueryClipbrdViewer( hab )

hwndClipbrdViewer (HWND) - returns

Current clipboard viewer window handle.

NULLHANDLE: Clipboard does not have a current viewer window, or an error occurred

Other: Current clipboard viewer window handle.

This example finds out which window currently owns the clipboard.

#define INCL_WINCLIPBOARD
#include <os2.h>
HAB hab;
/* . */
HWND  hwndClipbrdViewer;

hwndClipbrdViewer = WinQueryClipbrdViewer(hab);

@@ Line 1: / Line 1: @@
 This function obtains any current clipboard viewer window.
 ==Syntax==
   WinQueryClipbrdViewer( ''hab'' )
 ==Parameters==
-;hab (HAB) - input
+;''hab'' (HAB) - input:Anchor-block handle.
-:Anchor-block handle.
 ==Returns==
-;hwndClipbrdViewer (HWND) - returns
+;''hwndClipbrdViewer'' (HWND) - returns:Current clipboard viewer window handle.
-:Current clipboard viewer window handle.
+::NULLHANDLE: Clipboard does not have a current viewer window, or an error occurred
-:;NULLHANDLE
+::Other: Current clipboard viewer window handle.
-::Clipboard does not have a current viewer window, or an error occurred
-:;Other
-::Current clipboard viewer window handle.
 ==Example Code==
-Definition:
-<pre>
-#define INCL_WINCLIPBOARD /* Or use INCL_WIN, INCL_PM, */
-#include <os2.h>
-HAB     hab;                /*  Anchor-block handle. */
-HWND    hwndClipbrdViewer;  /*  Current clipboard viewer window handle. */
-hwndClipbrdViewer = WinQueryClipbrdViewer(hab);
-</pre>
 This example finds out which window currently owns the clipboard.
 <pre>
 #define INCL_WINCLIPBOARD
-#include <OS2.H>
+#include <os2.h>
 HAB hab;
 /* . */
 HWND  hwndClipbrdViewer;
 hwndClipbrdViewer = WinQueryClipbrdViewer(hab);
 </pre>
@@ Line 50: / Line 35: @@
 * [[WinSetClipbrdOwner]]
 * [[WinSetClipbrdViewer]]
-[[Category:Gpi]]
+[[Category:Win]]