Graphics::SetClip(HRGN, CombineMode) 메서드(gdiplusgraphics.h)

아티클
08/24/2023

Graphics::SetClip 메서드는 이 Graphics 개체의 클리핑 영역을 자체 및 Windows GDI(그래픽 디바이스 인터페이스) 영역의 조합인 지역으로 업데이트합니다.

구문

Status SetClip(
  [in] HRGN        hRgn,
  [in] CombineMode combineMode
);

매개 변수

[in] hRgn

형식: HRGN

이 Graphics 개체의 클리핑 영역과 결합할 GDI 영역에 대한 핸들입니다. 레거시 코드에 대해 제공됩니다. 새 애플리케이션은 Region 개체를 첫 번째 매개 변수로 전달해야 합니다.

[in] combineMode

형식: CombineMode

(선택 사항) GDI 영역을 이 Graphics 개체의 클리핑 영역과 결합하는 방법을 지정하는 CombineMode 열거형의 요소입니다. 기본값은 CombineModeReplace입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

이 메서드는 hRgn 에 지정된 GDI 영역이 이미 디바이스 단위에 있으므로 GDI 영역의 좌표를 변환하지 않는다고 가정합니다.

예제

다음 예제에서는 GDI 지역을 사용하여 클리핑 영역을 업데이트합니다.

VOID Example_SetClip2(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Region object, and get its handle.
   Region region(Rect(0, 0, 100, 100));
   HRGN hRegion = region.GetHRGN(&graphics);

   // Set the clipping region with hRegion.
   graphics.SetClip(hRegion);

   // Fill a rectangle to demonstrate the clipping region.
   graphics.FillRectangle(&SolidBrush(Color(255, 0, 0, 0)), 0, 0, 500, 500);
}

요구 사항


지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	gdiplusgraphics.h(Gdiplus.h 포함)
라이브러리	Gdiplus.lib
DLL	Gdiplus.dll