GetClipRgn 함수(wingdi.h)

GetClipRgn 함수는 지정된 디바이스 컨텍스트에 대한 현재 애플리케이션 정의 클리핑 영역을 식별하는 핸들을 검색합니다.

구문

int GetClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn
);

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다.

[in] hrgn

함수가 호출되기 전에 기존 지역에 대한 핸들입니다. 함수가 반환된 후 이 매개 변수는 현재 클리핑 영역의 복사본에 대한 핸들입니다.

함수가 성공하고 지정된 디바이스 컨텍스트에 대한 클리핑 영역이 없는 경우 반환 값은 0입니다. 함수가 성공하고 지정된 디바이스 컨텍스트에 대한 클리핑 영역이 있는 경우 반환 값은 1입니다. 오류가 발생하면 반환 값은 -1입니다.

애플리케이션 정의 클리핑 영역은 SelectClipRgn 함수로 식별되는 클리핑 영역입니다. 애플리케이션이 BeginPaint 함수를 호출할 때 생성된 클리핑 영역이 아닙니다.

함수가 성공하면 hrgn 매개 변수는 현재 클리핑 영역의 복사본에 대한 핸들입니다. 이 복사본에 대한 후속 변경 내용은 현재 클리핑 영역에 영향을 미치지 않습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll