IUIAnimationStoryboard::AddTransitionBetweenKeyframes 메서드(uianimation.h)

아티클
08/26/2023

두 키 프레임 간에 전환을 추가합니다.

구문

HRESULT AddTransitionBetweenKeyframes(
  [in] IUIAnimationVariable   *variable,
  [in] IUIAnimationTransition *transition,
  [in] UI_ANIMATION_KEYFRAME  startKeyframe,
  [in] UI_ANIMATION_KEYFRAME  endKeyframe
);

매개 변수

[in] variable

전환을 추가할 애니메이션 변수입니다.

[in] transition

추가할 전환입니다.

[in] startKeyframe

새 전환의 시작을 지정하는 키 프레임입니다.

[in] endKeyframe

새 전환의 끝을 지정하는 키 프레임입니다. endKeyframe이 startKeyframe보다 먼저 스토리보드에 표시될 수 없습니다.

반환 값

메서드가 성공하면 S_OK가 반환되고, 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 Windows 애니메이션 오류 코드를 참조하세요.

반환 코드	설명
UI_E_TRANSITION_ALREADY_USED	이 전환은 이미 스토리보드에 추가되었거나 플레이가 완료되고 릴리스된 스토리보드에 추가되었습니다.
UI_E_TRANSITION_ECLIPSED	전환은 스토리보드에서 다른 전환의 시작을 가리킬 수 있습니다.
UI_E_START_KEYFRAME_AFTER_END	시작 키 프레임은 종료 키 프레임 이후에 발생할 수 있습니다.

설명

이 메서드는 지정된 전환을 스토리보드의 지정된 변수에 적용하고 지정된 키프레임에서 전환이 시작되고 종료됩니다. 기간 매개 변수를 지정하여 전환을 만든 경우 해당 기간은 시작 키 프레임과 종료 키 프레임 사이의 기간으로 덮어씁니다. 그렇지 않으면 필요에 따라 Windows 애니메이션의 전환 속도가 빨라지거나 느려집니다.

키 프레임은 스토리보드 내의 시간을 나타내며 전환의 시작 및 종료 시간을 지정하는 데 사용할 수 있습니다. 전환 끝에 키 프레임을 추가할 수 있으므로 스토리보드 시작부터 스토리보드가 재생될 때까지 해당 오프셋을 알 수 없습니다.

전환은 재생되는 순서대로 추가해야 합니다. 스토리보드의 이전 전환이 완료되기 전에 전환이 시작될 수 있습니다. 이 경우 새 전환에서 볼 수 있는 초기 값과 속도는 이전 전환의 상태에 따라 결정됩니다. 이전 전환이 시작되기 전에 전환을 시작할 수 없어야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista용 Windows 7, Windows Vista 및 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	uianimation.h
DLL	UIAnimation.dll