[ Home | Alpha index | Topic index | Tutorials | Download | Feedback ]

The OS/2 API Project

WinBeginPaint

[ Syntax | Params | Returns | Include | Usage | Structs | Gotchas | Code | Also ]

Syntax

hps = WinBeginPaint( hwnd, hps, prcl );

Parameters

HWND hwnd (input)
A window handle to where the drawing is going to occur.

HPS hps (input)
A handle to presentation space.

PRECTL prcl (input)
A pointer to the bounding rectangle. The value must be in the range of -32,767 through 32,767. A NULL value indicates no bounding rectangle (the whole window will be painted).

Returns

HPS hps
Handle to the newly created presentation space. NULLHANDLE is returned if there was an error. WinGetLastError will return one of:

0x1001 PMERR_INVALID_HWND
0x207F PMERR_INV_HPS

Include Info

#define INCL_WINWINDOWMGR
#include <os2.h>

Usage Explanation

This function is called (normally in a WM_PAINT message) to obtain presentation space for drawing in a specified window.

Relevant Structures

Gotchas

Sample Code

#define INCL_WINWINDOWMGR #include <os2.h> . . . case WM_PAINT: hps = WinBeginPaint(hwnd, NULLHANDLE, NULL); WinQueryWindowRect(hwnd, &rcl); WinDrawText(hps, -1, "Hello World", &rcl, CLR_NEUTRAL, CLR_BACKGROUND, DT_CENTER | DT_VCENTER | DT_ERASERECT); WinEndPaint(hps); return 0; . . .

See Also

WinEndPaint, WinExcludeUpdateRegion, WinGetClipPS, WinGetPS, WinGetScreenPS, WinInvalidateRect, WinInvalidateRegion, WinIsWindowShowing, WinIsWindowVisible, WinLockVisRegions, WinOpenWindowDC, WinQueryUpdateRect, WinQueryUpdateRegion, WinRealizePalette, WinReleasePS, WinShowWindow, WinUpdateWindow, WinValidateRect, WinValidateRegion

Author

Bill Buchanan - billb@ic.net

Additions

Last modified July 12/1996
Please send all errors, comments, and suggestions to: timur@vnet.ibm.com

The OS/2 API Project

WinBeginPaint