GetUpdateRect 함수(winuser.h)

아티클
08/27/2023

GetUpdateRect 함수는 지정된 창의 업데이트 영역을 완전히 묶는 가장 작은 사각형의 좌표를 검색합니다. GetUpdateRect 는 논리 좌표에서 사각형을 검색합니다. 업데이트 지역이 없는 경우 GetUpdateRect 는 빈 사각형을 검색합니다(모든 좌표를 0으로 설정).

구문

BOOL GetUpdateRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect,
  [in]  BOOL   bErase
);

매개 변수

[in] hWnd

업데이트 지역을 검색할 창에 대한 핸들입니다.

[out] lpRect

바깥쪽 사각형의 좌표(디바이스 단위)를 수신하는 RECT 구조체에 대한 포인터입니다.

애플리케이션은 이 매개 변수를 NULL 로 설정하여 창에 대한 업데이트 지역이 있는지 여부를 확인할 수 있습니다. 이 매개 변수가 NULL인 경우 GetUpdateRect 는 업데이트 지역이 있는 경우 0이 아닌 값을 반환하고, 그렇지 않으면 0을 반환합니다. 이렇게 하면 WM_PAINT 메시지가 잘못된 영역에서 발생했는지 여부를 결정하는 간단하고 효율적인 방법을 제공합니다.

[in] bErase

업데이트 지역의 배경을 지울지 여부를 지정합니다. 이 매개 변수가 TRUE 이고 업데이트 지역이 비어 있지 않으면 GetUpdateRect 는 지정된 창에 WM_ERASEBKGND 메시지를 보내 배경을 지웁니다.

반환 값

업데이트 지역이 비어 있지 않으면 반환 값이 0이 아닙니다.

업데이트 지역이 없으면 반환 값은 0입니다.

설명

BeginPaint 함수에서 검색한 업데이트 사각형은 GetUpdateRect에서 검색한 것과 동일합니다.

BeginPaint는 업데이트 지역의 유효성을 자동으로 검사하므로 BeginPaint 호출 직후에 수행된 GetUpdateRect 호출은 빈 업데이트 지역을 검색합니다.

요구 사항


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