ValidateRect 함수(winuser.h)

ValidateRect 함수는 지정된 창의 업데이트 영역에서 사각형을 제거하여 사각형 내의 클라이언트 영역의 유효성을 검사합니다.

구문

BOOL ValidateRect(
  [in] HWND       hWnd,
  [in] const RECT *lpRect
);

[in] hWnd

업데이트 지역을 수정할 창에 대한 핸들입니다. 이 매개 변수가 NULL이면 시스템은 모든 창을 무효화하고 다시 그리며 함수가 반환되기 전에 WM_ERASEBKGND 및 WM_NCPAINT 메시지를 창 프로시저로 보냅니다.

[in] lpRect

업데이트 지역에서 제거할 사각형의 클라이언트 좌표를 포함하는 RECT 구조체에 대한 포인터입니다. 이 매개 변수가 NULL이면 전체 클라이언트 영역이 제거됩니다.

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다.

BeginPaint 함수는 전체 클라이언트 영역의 유효성을 자동으로 검사합니다. 다음 WM_PAINT 메시지가 생성되기 전에 업데이트 영역의 일부의 유효성을 검사해야 하는 경우 ValidateRect 또는 ValidateRgn 함수를 호출하지 않아야 합니다.

시스템은 현재 업데이트 지역의 유효성을 검사할 때까지 WM_PAINT 메시지를 계속 생성합니다.


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-draw-l1-1-0(Windows 8에서 도입)