IDCompositionVisual::SetTransform(IDCompositionTransform*) 메서드(dcomp.h)
이 시각적 개체의 Transform 속성을 지정된 2D 변환 개체로 설정합니다.
구문
HRESULT SetTransform(
[in, optional] IDCompositionTransform *transform
);
매개 변수
[in, optional] transform
이 시각적 개체의 좌표계를 수정하는 데 사용되는 변환 개체입니다. 이 매개 변수는 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 |
추가 정보
IDCompositionTranslateTransform