다음을 통해 공유


IDCompositionVisual::SetOffsetY(IDCompositionAnimation*) 메서드(dcomp.h)

이 시각적 개체의 OffsetY 속성 값에 애니메이션 효과를 옵니다. OffsetY 속성은 부모 시각적 개체를 기준으로 y축을 따라 시각적 개체의 새 오프셋을 지정합니다.

구문

HRESULT SetOffsetY(
  [in] IDCompositionAnimation *animation
);

매개 변수

[in] animation

형식: IDCompositionAnimation*

시간에 따라 OffsetY 속성의 값이 변경되는 방식을 결정하는 애니메이션 개체입니다. 이 매개 변수는 NULL이 아니어야 합니다.

반환 값

형식: HRESULT

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

설명

이 메서드는 지정된 애니메이션의 복사본을 만듭니다. 이 호출 후 애니메이션 매개 변수에서 참조하는 애니메이션 개체가 변경되면 이 메서드가 다시 호출되지 않는 한 OffsetY 속성에 영향을 주지 않습니다. OffsetY 속성이 이전에 애니메이션 효과를 준 경우 이 메서드는 해당 애니메이션을 새 애니메이션으로 바꿉니다.

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

요구 사항

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

추가 정보

IDCompositionVisual

IDCompositionVisual::SetOffsetX

IDCompositionVisual::SetTransform