IDCompositionVisual::SetOffsetX(float) 메서드(dcomp.h)
이 시각적 개체의 OffsetX 속성 값을 변경합니다. OffsetX 속성은 부모 시각적 개체를 기준으로 x축을 따라 시각적 개체의 새 오프셋을 지정합니다.
구문
HRESULT SetOffsetX(
[in] float offsetX
);
매개 변수
[in] offsetX
형식: float
x축을 따라 시각적 개체의 새 오프셋(픽셀)입니다.
반환 값
형식: HRESULT
함수가 성공하면 S_OK를 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 DirectComposition 오류 코드를 참조하세요.
설명
offsetX 매개 변수가 NaN, 양수 무한대 또는 음의 무한대인 경우 이 메서드는 실패합니다.
시각적 개체의 OffsetX 속성을 변경하면 해당 시각적 개체에 루팅된 전체 시각적 개체 하위 트리의 좌표계가 변환됩니다. 이 시각적 개체의 Clip 속성을 지정하면 클립 사각형도 변환됩니다.
Transform 속성에 지정된 변환은 OffsetX 속성 다음에 적용됩니다. 즉, Transform 속성과 OffsetX 속성을 설정하는 효과는 그룹의 첫 번째 멤버가 offsetX와 동일한 OffsetX 값을 가진 IDCompositionTranslateTransform 개체인 변환 그룹 개체에서 Transform 속성만 설정하는 것과 같습니다. 그러나 가능하면 약간 더 빠르므로 IDCompositionVisual::SetOffsetX 를 사용해야 합니다.
OffsetX 및 OffsetY 속성이 0으로 설정되고 Transform 속성이 NULL로 설정된 경우 시각적 개체의 좌표계는 해당 부모의 좌표계와 동일합니다.
OffsetX 속성이 이전에 애니메이션 효과를 준 경우 이 메서드는 애니메이션을 제거하고 속성을 지정된 정적 값으로 설정합니다.
예제
예제는 간단한 시각적 트리를 빌드하는 방법을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | dcomp.h |
| 라이브러리 | Dcomp.lib |
| DLL | Dcomp.dll |