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에 도입됨) |