WinBeginPaint: Difference between revisions
mNo edit summary |
|||
| (One intermediate revision by the same user not shown) | |||
| 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> | ||
| Line 46: | Line 46: | ||
==See Also== | ==See Also== | ||
*[[WinEndPaint]] | * [[WinEndPaint]] | ||
*WinExcludeUpdateRegion | * [[WinExcludeUpdateRegion]] | ||
*WinGetClipPS | * [[WinGetClipPS]] | ||
*WinGetPS | * [[WinGetPS]] | ||
*WinGetScreenPS | * [[WinGetScreenPS]] | ||
*WinInvalidateRect | * [[WinInvalidateRect]] | ||
*WinInvalidateRegion | * [[WinInvalidateRegion]] | ||
*WinIsWindowShowing | * [[WinIsWindowShowing]] | ||
*WinIsWindowVisible | * [[WinIsWindowVisible]] | ||
*WinLockVisRegions | * [[WinLockVisRegions]] | ||
*WinOpenWindowDC | * [[WinOpenWindowDC]] | ||
*WinQueryUpdateRect | * [[WinQueryUpdateRect]] | ||
*WinQueryUpdateRegion | * [[WinQueryUpdateRegion]] | ||
*WinRealizePalette | * [[WinRealizePalette]] | ||
*WinReleasePS | * [[WinReleasePS]] | ||
*WinShowWindow | * [[WinShowWindow]] | ||
*WinUpdateWindow | * [[WinUpdateWindow]] | ||
*WinValidateRect | * [[WinValidateRect]] | ||
*WinValidateRegion | * [[WinValidateRegion]] | ||
[[Category:Win]] | [[Category:Win]] | ||
Latest revision as of 18:32, 14 May 2025
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