다음을 통해 공유


ExtSelectClipRgn 함수(wingdi.h)

ExtSelectClipRgn 함수는 지정된 모드를 사용하여 지정된 영역을 현재 클리핑 영역과 결합합니다.

구문

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

매개 변수

[in] hdc

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

[in] hrgn

선택할 지역에 대한 핸들입니다. RGN_COPY 모드를 지정하지 않는 한 이 핸들은 NULL 이 아니어야 합니다.

[in] mode

수행할 작업입니다. 다음 값 중 하나여야 합니다.

의미
RGN_AND
새 클리핑 영역은 현재 클리핑 영역의 겹치는 영역과 hrgn으로 식별된 영역을 결합합니다.
RGN_COPY
새 클리핑 영역은 hrgn으로 식별되는 영역의 복사본입니다. SelectClipRgn과 동일합니다. hrgn으로 식별되는 지역이 NULL인 경우 새 클리핑 영역은 기본 클리핑 영역입니다(기본 클리핑 영역은 null 영역임).
RGN_DIFF
새 클리핑 영역은 현재 클리핑 영역의 영역을 hrgn으로 식별된 영역에서 제외된 영역과 결합합니다.
RGN_OR
새 클리핑 영역은 현재 클리핑 영역과 hrgn으로 식별된 영역을 결합합니다.
RGN_XOR
새 클리핑 영역은 현재 클리핑 영역과 hrgn 으로 식별된 영역을 결합하지만 겹치는 영역은 제외합니다.

반환 값

반환 값은 새 클리핑 영역의 복잡성을 지정합니다. 다음 값 중 하나일 수 있습니다.

반환 코드 설명
NULLREGION
지역이 비어 있습니다.
SIMPLEREGION
지역은 단일 사각형입니다.
COMPLEXREGION
영역이 두 개 이상의 사각형입니다.
ERROR
오류가 발생했습니다.

설명

이 함수가 호출될 때 오류가 발생하면 지정된 디바이스 컨텍스트에 대한 이전 클리핑 영역은 영향을 받지 않습니다.

ExtSelectClipRgn 함수는 지정된 영역에 대한 좌표가 디바이스 단위로 지정되어 있다고 가정합니다.

hrgn 매개 변수로 식별된 영역의 복사본만 사용됩니다. 이 호출 후에 지역 자체를 다시 사용하거나 삭제할 수 있습니다.

요구 사항

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

추가 정보

클리핑 함수

클리핑 개요

SelectClipRgn