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 속성이 이전에 애니메이션 효과를 준 경우 이 메서드는 애니메이션을 제거하고 속성을 지정된 정적 값으로 설정합니다.

예제

예제는 간단한 시각적 트리를 빌드하는 방법을 참조하세요.

요구 사항

추가 정보

IDCompositionVisual

IDCompositionVisual::SetOffsetY

IDCompositionVisual::SetTransform