InvalidateRgn 함수(winuser.h)

InvalidateRgn 함수는 창의 현재 업데이트 영역에 추가하여 지정된 지역 내의 클라이언트 영역을 무효화합니다. 무효화된 영역은 업데이트 지역의 다른 모든 영역과 함께 다음 WM_PAINT 메시지가 발생할 때 그리기 위해 표시됩니다.

구문

BOOL InvalidateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bErase
);

[in] hWnd

수정할 업데이트 영역이 있는 창에 대한 핸들입니다.

[in] hRgn

업데이트 지역에 추가할 지역에 대한 핸들입니다. 지역에는 클라이언트 좌표가 있는 것으로 간주됩니다. 이 매개 변수가 NULL이면 전체 클라이언트 영역이 업데이트 지역에 추가됩니다.

[in] bErase

업데이트 영역이 처리될 때 업데이트 영역 내의 배경을 지울지 여부를 지정합니다. 이 매개 변수가 TRUE이면 BeginPaint 함수가 호출되면 배경이 지워집니다. 매개 변수가 FALSE이면 배경은 변경되지 않은 상태로 유지됩니다.

반환 값은 항상 0이 아닌 값입니다.

무효화된 영역은 다음 WM_PAINT 메시지가 처리되거나 ValidateRect 또는 ValidateRgn 함수를 사용하여 지역의 유효성이 검사될 때까지 업데이트 지역에 누적됩니다.

시스템은 업데이트 영역이 비어 있지 않고 해당 창에 대한 애플리케이션 큐에 다른 메시지가 없을 때마다 창에 WM_PAINT 메시지를 보냅니다.

지정된 지역은 지역 함수 중 하나를 사용하여 만들어야 합니다.

업데이트 영역의 모든 부분에 대해 bErase 매개 변수가 TRUE 이면 지정된 부분뿐만 아니라 전체 영역의 배경이 지워집니다.

요구 사항	값
지원되는 최소 클라이언트	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 도입)