IDCompositionVisual2::SetOpacityMode 메서드(dcomp.h)
이 시각적 개체의 불투명도 모드를 설정합니다.
구문
HRESULT SetOpacityMode(
[in] DCOMPOSITION_OPACITY_MODE mode
);
매개 변수
[in] mode
화면에 시각적 개체를 작성할 때 사용할 불투명 모드입니다.
반환 값
함수가 성공하면 S_OK를 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 DirectComposition 오류 코드를 참조하세요.
설명
불투명 모드는 효과 그룹 개체의 Opacity 속성이 시각적 하위 트리의 컴퍼지션에 미치는 영향에 영향을 줍니다. DirectComposition은 레이어 및 곱하기라는 두 가지 불투명 모드를 지원합니다. 계층 모드에서 각 시각적 하위 트리는 불투명 값이 적용되는 전체 하위 트리의 불투명 래스터화를 포함하는 비트맵으로 논리적으로 볼 수 있습니다. 이러한 방식으로 겹치는 불투명 표면은 하위 트리의 배경과 혼합되지만 서로 혼합되지는 않습니다. 반면 곱하기 모드에서는 불투명도가 구성될 때 각 표면에 개별적으로 적용되므로 표면이 서로 혼합됩니다. 곱하기 모드는 레이어 모드보다 빠르며 시각적 트리에 겹치지 않는 내용이 완전히 포함된 경우 항상 선호됩니다. 그러나 곱하기 모드는 겹치는 요소에 대해 원치 않는 시각적 결과를 생성할 수 있습니다.
기본적으로 시각적 개체는 부모 시각적 개체의 불투명도 모드를 상속하며, 부모 시각적 개체의 불투명 모드를 상속할 수 있습니다. 시각적 개체는 이 메서드가 시각적 개체에 대해 호출되지 않거나 이 메서드가 DCOMPOSITION_OPACITY_MODE_INHERIT 사용하여 호출되는 경우 DCOMPOSITION_OPACITY_MODE_LAYER 모드를 사용합니다. 불투명 모드를 설정하는 시각적 개체가 없는 경우 전체 시각적 트리의 기본값은 DCOMPOSITION_OPACITY_MODE_LAYER.
opacityMode 매개 변수가 DCOMPOSITION_OPACITY_MODE_INHERIT 이외의 경우 이 시각적 개체의 표면은 지정된 불투명 모드로 구성됩니다. 또한 이 불투명 모드는 현재 시각적 개체의 자식에 대한 새 기본값이 됩니다. 즉, 이 시각적 개체 자식의 불투명도 모드가 변경되지 않거나 명시적으로 DCOMPOSITION_OPACITY_MODE_INHERIT 설정되면 자식 시각적 개체가 이 시각적 개체의 불투명도 모드를 사용하여 구성됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8.1 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | dcomp.h |
| 라이브러리 | Dcomp.lib |
| DLL | Dcomp.dll |