WinBeginPaint: Difference between revisions
mNo edit summary |
No edit summary |
||
| Line 4: | Line 4: | ||
hps = WinBeginPaint( ''hwnd'', ''hps'', ''prcl'' ) | hps = WinBeginPaint( ''hwnd'', ''hps'', ''prcl'' ) | ||
== Parameters == | |||
;HWND ''hwnd'' (input):A window handle to where the drawing is going to occur. | ;HWND ''hwnd'' (input):A window handle to where the drawing is going to occur. | ||
;HPS ''hps'' (input):A handle to presentation space. | ;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). | ;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: | ;HPS hps:Handle to the newly created presentation space. NULLHANDLE is returned if there was an error. WinGetLastError will return one of: | ||
{|class="wikitable" | {|class="wikitable" | ||
| Line 19: | Line 19: | ||
|} | |} | ||
== Include Info == | |||
#define INCL_WINWINDOWMGR | #define INCL_WINWINDOWMGR | ||
#include <os2.h> | #include <os2.h> | ||
Revision as of 04:46, 20 May 2018
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