ValidateRgn

  BOOL ValidateRgn(hwnd, hRgn)    
  HWND hwnd; /* handle of window */
  HRGN hRgn; /* handle of valid region */

This function validates the client area within the given region by removing the region from the current update region of the given window. If the hRgn parameter is NULL, the entire window is validated.

Parameters

hwnd

Identifies the window whose update region is to be modified.

hRgn

Identifies a region that defines the area to be removed from the update region.

Return Value

Returns TRUE for success, FALSE for failure.

Comments

The given region must have been created previously by means of a region function (for more information, see Chapter 1, Window Manager Interface Functions). The region coordinates are assumed to be client coordinates.

See Also

ValidateRect, InvalidateRgn, InvalidateRect, BeginPaint, ExcludeUpdateRgn