IDCompositionVisual::SetClip(IDCompositionClip*) 메서드(dcomp.h)

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

구문

HRESULT SetClip(
  [in, optional] IDCompositionClip *clip
);

매개 변수

[in, optional] clip

형식: IDCompositionClip*

이 시각적 개체와 연결할 클립 개체입니다. 이 매개 변수는 NULL일 수 있습니다. IDCompositionRectangleClip의 모든 float 속성의 숫자 제한은 -2^21에서 2^21입니다. API는 이 범위를 벗어나는 숫자를 허용하지만 항상 이 범위로 고정됩니다.

반환 값

형식: HRESULT

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

설명

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

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

클립이 잘못된 포인터이거나 이 시각적 개체를 만든 동일한 IDCompositionDevice 인터페이스에 의해 만들어지지 않은 경우 이 메서드는 실패합니다. 인터페이스는 사용자 지정 구현일 수 없습니다. Microsoft DirectComposition에서 만든 인터페이스만 이 메서드와 함께 사용할 수 있습니다.

클립이 NULL이면 시각적 개체가 부모에 상대적으로 잘리지 않습니다. 그러나 시각적 개체는 부모 시각적 개체의 클립 개체 또는 클립 개체가 있는 가장 가까운 상위 시각적 개체에 의해 잘립니다. 클립을 NULL로 설정하는 것은 클립 사각형의 왼쪽과 위쪽 면이 음의 무한대로 설정되고 오른쪽과 아래쪽이 양수 무한대로 설정된 클립 개체를 지정하는 것과 비슷합니다. NULL 클립 개체를 사용하면 성능이 약간 향상됩니다.

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

요구 사항

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

추가 정보

클리핑

IDCompositionRectangleClip

IDCompositionVisual