IDCompositionVisual::SetClip(constD2D_RECT_F&) 메서드(dcomp.h)

이 시각적 개체의 Clip 속성을 지정된 사각형으로 설정합니다. Clip 속성은 이 시각적 개체에 루팅된 시각적 개체 하위 트리의 렌더링을 지정된 사각형 영역으로 제한합니다.

구문

HRESULT SetClip(
  [in, ref] const D2D_RECT_F & rect
);

매개 변수

[in, ref] rect

형식: const D2D_RECT_F

이 시각적 개체를 클리핑하는 데 사용할 사각형입니다. rect 매개 변수의 모든 속성의 숫자 제한은 -2^21에서 2^21로 제한됩니다. API는 이 범위를 벗어나는 숫자를 허용하지만 항상 이 범위로 고정됩니다.

반환 값

형식: HRESULT

함수가 성공하면 S_OK를 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 DirectComposition 오류 코드를 참조하세요.

설명

Clip 속성을 설정하면 이 시각적 개체에 루팅된 하위 트리의 모든 시각적 개체와 함께 이 시각적 개체가 클립됩니다. 클립은 OffsetX, OffsetY 및 Transform 속성으로 변환됩니다.

Clip 속성이 이전에 클립 개체를 지정한 경우 새로 지정한 클립 사각형이 클립 개체를 대체합니다.

사각형 구조체의 멤버가 NaN, 양의 무한대 또는 음의 무한대인 경우 이 메서드는 실패합니다.

클립 사각형이 비어 있으면 시각적 개체가 완전히 잘립니다. 즉, 시각적 개체는 시각적 트리에 포함되지만 아무것도 렌더링하지 않습니다. 컴퍼지션에서 특정 시각적 개체를 제외하려면 빈 클립 사각형을 설정하는 대신 시각적 트리에서 시각적 개체를 제거합니다. 시각적 개체를 제거하면 성능이 향상됩니다.

요구 사항

지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dcomp.h
라이브러리	Dcomp.lib
DLL	Dcomp.dll

추가 정보

클리핑

IDCompositionRectangleClip

IDCompositionVisual