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>> 등)으로 시작되도록 지정합니다.
[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 |