GetUpdateRgn 함수(winuser.h)

GetUpdateRgn 함수는 지정된 지역에 복사하여 창의 업데이트 영역을 검색합니다. 업데이트 영역의 좌표는 창의 왼쪽 위 모서리(즉, 클라이언트 좌표)를 기준으로 합니다.

구문

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

매개 변수

[in] hWnd

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

[in] hRgn

업데이트 지역을 받을 지역에 대한 핸들입니다.

[in] bErase

창 배경을 지울지 여부와 자식 창의 비클라이언트 영역을 그릴지 여부를 지정합니다. 이 매개 변수가 FALSE이면 그리기는 수행되지 않습니다.

반환 값

반환 값은 결과 영역의 복잡성을 나타냅니다. 다음 값 중 하나일 수 있습니다.

의미
COMPLEXREGION 지역은 둘 이상의 사각형으로 구성됩니다.
오류 오류가 발생했습니다.
NULLREGION 지역이 비어 있습니다.
SIMPLEREGION 지역은 단일 사각형입니다.

설명

BeginPaint 함수는 업데이트 영역의 유효성을 자동으로 검사하므로 BeginPaint 호출 직후 GetUpdateRgn을 호출하면 빈 업데이트 지역이 검색됩니다.

요구 사항

   
지원되는 최소 클라이언트 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에 도입됨)

추가 정보

그리기 및 그리기 함수

그리기 및 그리기 개요