[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
InvalidateRect( hWnd, lErase )-> nil
OR
InvalidateRect( hWnd, aRect, lErase )-> nil
------------------------------------------------------------------------------
PARAMETER:
<hWnd> Is the handle of the window whose update region gets invalid
and should be painted.
<aRect> Specifies the dimensions of the rectangle that needs to be
updated: { nTop, nLeft, nBottom, nRight }. If this parameter
is not supplied, the whole window area gets invalid
<lErase> Specifies whether the background within the update region is
to be erased when the update region is processed. It this
parameter is TRUE, the background is erased when the
BeginPaint function is called. If this parameter is FALSE,
the background remains unchanged.
DESCRIPTION:
This function forces a window region or its whole area to be repainted.
Basically it generates a WM_PAINT message.
The invalidated areas accumulate in the update region until the region is
processed when the next WM_PAINT message occurs, or until the region is
validated by using the ValidateRect function.
Windows sends a WM_PAINT message to a window whenever its update region
is not empty and there are no other messages in the application queue for
that window. If <lErase> is TRUE for any part of the update region,
the background is erased in the entire region, not just in the given part.
EXAMPLE:
+--------------------------------------------------------------+
| /* TWINDOW'S Refresh Method : */ |
| METHOD REFRESH(lErase) INLINE InvalidateRect( ::hWnd,; |
| IF( lErase == nil, .T., lErase)) |
| |
+--------------------------------------------------------------+
SOURCE:
SOURCE\WINAPI\INVALREC.C
See Also:
BeginPaint
Refresh
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson