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

지정된 두 키 프레임 사이에 루프를 만듭니다.

구문

HRESULT RepeatBetweenKeyframes(
  [in] UI_ANIMATION_KEYFRAME startKeyframe,
  [in] UI_ANIMATION_KEYFRAME endKeyframe,
  [in] INT32                 repetitionCount
);

매개 변수

[in] startKeyframe

루프를 시작할 키 프레임입니다.

[in] endKeyframe

루프가 종료되는 키 프레임입니다. endKeyframe이 startKeyframe보다 먼저 스토리보드에서 발생할 수 없습니다.

[in] repetitionCount

루프를 반복할 횟수입니다. 이 매개 변수는 0 또는 양수여야 합니다. 스토리보드가 잘리거나 종료될 때까지 UI_ANIMATION_REPEAT_INDEFINITELY (-1)를 사용하여 루프를 무기한 반복합니다.

반환 값

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

반환 코드 설명
UI_E_START_KEYFRAME_AFTER_END
시작 키 프레임은 종료 키 프레임 이후에 발생할 수 있습니다.
UI_E_END_KEYFRAME_NOT_DETERMINED
시작 키 프레임에 도달할 때 종료 키 프레임 시간을 확인할 수 없습니다.
UI_E_LOOPS_OVERLAP
스토리보드의 반복된 두 부분이 겹칠 수 있습니다.

설명

이 메서드는 스토리보드의 나머지 부분을 재생하기 전에 지정된 키 프레임 사이의 간격을 반복적으로 재생하도록 스토리보드를 지시합니다. 한정된 반복 횟수를 지정하면 루프는 항상 해당 횟수를 재생합니다. UI_ANIMATION_REPEAT_INDEFINITELY(-1)을 지정하면 스토리보드가 종료될 때까지 루프가 반복됩니다. 이 경우 루프의 현재 반복이 완료되고 나머지 스토리보드가 재생됩니다. 무한 반복되는 스토리보드는 잘리면 종료됩니다.

중첩 및 겹치는 루프는 지원되지 않습니다.

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

요구 사항

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

추가 정보

IUIAnimationStoryboard

IUIAnimationStoryboard::AddKeyframeAfterTransition

IUIAnimationStoryboard::AddKeyframeAtOffset