ExtSelectClipRgn 함수(wingdi.h)
ExtSelectClipRgn 함수는 지정된 모드를 사용하여 지정된 영역을 현재 클리핑 영역과 결합합니다.
구문
int ExtSelectClipRgn(
[in] HDC hdc,
[in] HRGN hrgn,
[in] int mode
);
매개 변수
[in] hdc
디바이스 컨텍스트에 대한 핸들입니다.
[in] hrgn
선택할 지역에 대한 핸들입니다. RGN_COPY 모드를 지정하지 않는 한 이 핸들은 NULL 이 아니어야 합니다.
[in] mode
수행할 작업입니다. 다음 값 중 하나여야 합니다.
값 | 의미 |
---|---|
|
새 클리핑 영역은 현재 클리핑 영역의 겹치는 영역과 hrgn으로 식별된 영역을 결합합니다. |
|
새 클리핑 영역은 hrgn으로 식별되는 영역의 복사본입니다. SelectClipRgn과 동일합니다. hrgn으로 식별되는 지역이 NULL인 경우 새 클리핑 영역은 기본 클리핑 영역입니다(기본 클리핑 영역은 null 영역임). |
|
새 클리핑 영역은 현재 클리핑 영역의 영역을 hrgn으로 식별된 영역에서 제외된 영역과 결합합니다. |
|
새 클리핑 영역은 현재 클리핑 영역과 hrgn으로 식별된 영역을 결합합니다. |
|
새 클리핑 영역은 현재 클리핑 영역과 hrgn 으로 식별된 영역을 결합하지만 겹치는 영역은 제외합니다. |
반환 값
반환 값은 새 클리핑 영역의 복잡성을 지정합니다. 다음 값 중 하나일 수 있습니다.
반환 코드 | 설명 |
---|---|
|
지역이 비어 있습니다. |
|
지역은 단일 사각형입니다. |
|
영역이 두 개 이상의 사각형입니다. |
|
오류가 발생했습니다. |
설명
이 함수가 호출될 때 오류가 발생하면 지정된 디바이스 컨텍스트에 대한 이전 클리핑 영역은 영향을 받지 않습니다.
ExtSelectClipRgn 함수는 지정된 영역에 대한 좌표가 디바이스 단위로 지정되어 있다고 가정합니다.
hrgn 매개 변수로 식별된 영역의 복사본만 사용됩니다. 이 호출 후에 지역 자체를 다시 사용하거나 삭제할 수 있습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | wingdi.h(Windows.h 포함) |
라이브러리 | Gdi32.lib |
DLL | Gdi32.dll |