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

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

구문

HRESULT RepeatBetweenKeyframes(
  [in] UI_ANIMATION_KEYFRAME                   startKeyframe,
  [in] UI_ANIMATION_KEYFRAME                   endKeyframe,
  [in] DOUBLE                                  cRepetition,
  [in] UI_ANIMATION_REPEAT_MODE                repeatMode,
  [in] IUIAnimationLoopIterationChangeHandler2 *pIterationChangeHandler,
  [in] UINT_PTR                                id,
  [in] BOOL                                    fRegisterForNextAnimationEvent
);

매개 변수

[in] startKeyframe

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

[in] endKeyframe

루프가 종료되는 키 프레임입니다. endKeyframe은 startKeyframe 보다 먼저 스토리보드에서 발생해서는 안 됩니다.

[in] cRepetition

루프를 반복할 횟수입니다. 루프의 마지막 반복은 키 프레임 간에 부분적으로 종료할 수 있습니다. 값이 0이면 스토리보드의 지정된 부분이 재생되지 않음을 나타냅니다. UI_ANIMATION_REPEAT_INDEFINITELY(-1) 값은 스토리보드가 잘리거나 종료될 때까지 루프가 무기한 반복됨을 나타냅니다.

[in] repeatMode

루프 반복에 대한 패턴입니다.

UI_ANIMATION_REPEAT_MODE_ALTERNATE 값(1)은 루프의 시작이 키프레임(k1-k2, k2-k1>, k1-k2>> 등)을 번갈아 가도록 지정합니다.

UI_ANIMATION_REPEAT_MODE_NORMAL(0) 값은 루프의 시작이 첫 번째 키 프레임(k1-k2, k1-k2>, k1-k2>> 등)으로 시작되도록 지정합니다.

참고repeatMode 의 값이 UI_ANIMATION_REPEAT_MODE_ALTERNATE (1)이고 cRepetition 값이 UI_ANIMATION_REPEAT_INDEFINITELY (-1)인 경우 루프는 끝 키 프레임에서 종료됩니다.

 

[in] pIterationChangeHandler

각 루프 반복 이벤트에 대한 처리기입니다. 기본값은 0입니다.

[in] id

pIterationChangeHandler에 전달할 루프 ID입니다. 기본값은 0입니다.

[in] fRegisterForNextAnimationEvent

true이면 iUIAnimationManager2::EstimateNextEventTime 메서드에서 반환되는 다음 애니메이션 이벤트까지 pIterationChangeHandler가 예상 시간 간격에 통합되도록 지정합니다. 기본값은 0 또는 false입니다.

반환 값

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

설명

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

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

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

요구 사항

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

추가 정보

IUIAnimationStoryboard2

IUIAnimationStoryboard2::AddKeyframeAfterTransition

IUIAnimationStoryboard2::AddKeyframeAtOffset