다음을 통해 공유

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