GweBypassCoredllThunk_t::ValidateRect_I

This method validates the client area within a rectangle by removing the rectangle from the update region of the specified window.

static BOOL WINAPI ValidateRect_I(
  HWND hwndThis,
  CONST RECT* lpRect
);

Parameters

  • hwndThis
    [in] Handle to the window whose update region is to be modified.
  • lpRect
    [in] Long pointer to a RECT structure that contains the client coordinates of the rectangle to be removed from the update region. If this parameter is NULL, the entire client area is removed.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

This method is an internal version of the ValidateRect function.

Passing in a NULL value for the hWndThis parameter is not supported.

The GweBypassCoredllThunk_t::BeginPaint_I method automatically validates the entire client area. GweBypassCoredllThunk_t::ValidateRect_I should be called if a portion of the update region must be validated before the next WM_PAINT message is generated.

The system continues to generate WM_PAINT messages until the current update region is validated.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: GweBypassCoredllThunk.hpp.

See Also

ValidateRect | GweBypassCoredllThunk_t::BeginPaint_I | GweBypassCoredllThunk_t::InvalidateRect_I | WM_ERASEBKGND | WM_PAINT | RECT

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.