WinBeginPaint
Appearance
This function is called (normally in a WM_PAINT message) to obtain presentation space for drawing in a specified window.
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>
Sample Code
#define INCL_WINWINDOWMGR #include . . . 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