WinSetClipbrdOwner
This function sets the current clipboard-owner window.
Syntax
WinSetClipbrdOwner( hab, hwnd )
Parameters
- hab (HAB) - input
- Anchor-block handle.
- hwnd (HWND) - input
- Window handle of the new clipboard owner.
- NULLHANDLE: Clipboard-owner window is released and no new clipboard-owner window is established.
- Other: Window handle of the new clipboard owner.
Returns
- rc (BOOL) - returns
- Success indicator.
- TRUE: Successful completion
- FALSE: Error occurred.
Errors
Possible returns from WinGetLastError
- PMERR_INVALID_HWND (0x1001) An invalid window handle was specified.
Remarks
The clipboard owner window receives the following clipboard-related messages at appropriate times:
- WM_DESTROYCLIPBOARD
- WM_HSCROLLCLIPBOARD
- WM_PAINTCLIPBOARD
- WM_RENDERALLFMTS
- WM_RENDERFMT
- WM_SIZECLIPBOARD
- WM_VSCROLLCLIPBOARD
Example Code
This example places a bit map into the clipboard.
#define INCL_WINCLIPBOARD
#include <os2.h>
HAB hab; /* anchor-block handle. */
HBITMAP bmap; /* bit-map handle. */
HWND hwnd;
WinOpenClipbrd(hab);
WinSetClipbrdOwner(hab,
hwnd); /* window handle of the clipboard */
/* owner. */
WinSetClipbrdData(hab,
(ULONG)bmap,
CF_BITMAP,
CFI_HANDLE); /* tells the system that the */
/* bmap parameter is a handle */
/* to a bit map. */
WinCloseClipbrd(hab);