[<<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