IDCompositionVisual::SetTransform(IDCompositionTransform*) 메서드(dcomp.h)

아티클
08/23/2023

이 시각적 개체의 Transform 속성을 지정된 2D 변환 개체로 설정합니다.

구문

HRESULT SetTransform(
  [in, optional] IDCompositionTransform *transform
);

매개 변수

[in, optional] transform

형식: IDCompositionTransform*

이 시각적 개체의 좌표계를 수정하는 데 사용되는 변환 개체입니다. 이 매개 변수는 IDCompositionTransform 인터페이스 또는 파생된 인터페이스 중 하나를 가리킬 수 있습니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

형식: HRESULT

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

설명

Transform 속성을 설정하면 이 시각적 개체에 루팅된 전체 시각적 개체 하위 트리의 좌표계가 변환됩니다. 이 시각적 개체의 Clip 속성을 지정하면 클립 사각형도 변환됩니다.

Transform 속성이 이전에 변환 행렬을 지정한 경우 새로 지정한 변환 개체가 변환 행렬을 대체합니다.

Transform 속성에 지정된 변환은 OffsetX 및 OffsetY 속성 다음에 적용됩니다. 즉, Transform 속성과 OffsetX 및 OffsetY 속성을 설정하는 효과는 그룹의 첫 번째 멤버가 동일한 OffsetX 및 OffsetY 값을 가진 IDCompositionTranslateTransform 개체인 변환 그룹에서 Transform 속성만 설정하는 것과 같습니다. 그러나 IDCompositionVisual::SetOffsetX 및 SetOffsetY 메서드는 약간 더 빠르므로 가능하면 언제든지 사용해야 합니다.

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

변환 매개 변수가 NULL이면 이 시각적 개체의 좌표계는 OffsetX 및 OffsetY 속성에 의해서만 변환됩니다. Transform 속성을 NULL로 설정하는 것은 ID 행렬이 ID 행렬인 IDCompositionMatrixTransform 개체로 설정하는 것과 같습니다. 그러나 애플리케이션은 약간 더 빠르기 때문에 가능하면 언제든지 Transform 속성을 NULL로 설정해야 합니다.

OffsetX 및 OffsetY 속성이 0으로 설정되고 Transform 속성이 NULL로 설정된 경우 시각적 개체의 좌표계는 해당 부모의 좌표계와 동일합니다.

요구 사항


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