GetWindowRgn 함수(winuser.h)

GetWindowRgn 함수는 창의 창 영역 복사본을 가져옵니다. 창의 창 영역은 SetWindowRgn 함수를 호출하여 설정됩니다. 창 영역은 시스템에서 그리기를 허용하는 창 내의 영역을 결정합니다. 시스템에서 창 영역 외부에 있는 창의 일부를 표시하지 않습니다.

구문

int GetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

매개 변수

[in] hWnd

창 영역을 가져올 창에 대한 핸들입니다.

[in] hRgn

창 영역을 나타내도록 수정할 영역에 대한 핸들입니다.

반환 값

반환 값은 함수가 가져오는 영역의 형식을 지정합니다. 다음 값 중 하나일 수 있습니다.

반환 코드	설명
NULLREGION	지역이 비어 있습니다.
SIMPLEREGION	지역은 단일 사각형입니다.
COMPLEXREGION	영역이 두 개 이상의 사각형입니다.
ERROR	지정된 창에 지역이 없거나 지역을 반환하는 동안 오류가 발생했습니다.

설명

창 창 영역의 좌표는 창의 클라이언트 영역이 아니라 창의 왼쪽 위 모서리를 기준으로 합니다.

창의 창 영역을 설정하려면 SetWindowRgn 함수를 호출합니다.

예제

다음 코드에서는 기존 지역의 핸들을 전달하는 방법을 보여 있습니다.

HRGN hrgn = CreateRectRgn(0,0,0,0);
int regionType = GetWindowRgn(hwnd, hrgn);
if (regionType != ERROR) 
{ 
/* hrgn contains window region */ 
}
DeleteObject(hrgn); /* finished with region */

요구 사항

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

추가 정보

그리기 및 그리기 함수

그리기 및 그리기 개요

SetWindowRgn