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 |