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
迴圈重複的次數;循環的最後一個反覆專案可以在主要畫面格之間以小數部分方式終止。 值為零表示不會播放分鏡腳本的指定部分。 值 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 的循環標識碼。 預設值為 0。
[in] fRegisterForNextAnimationEvent
如果為 true，指定 pIterationChangeHandler 會併入時間間隔的估計，直到 IUIAnimationManager2：：EstimateNextEventTime 方法傳回的下一個動畫事件為止。 默認值為 0 或 false。
傳回值
如果此方法成功，則會傳回S_OK。 否則，它會傳回 HRESULT 錯誤碼。 如需錯誤碼的清單，請參閱 Windows 動畫錯誤 碼。
備註
此方法會指示分鏡腳本在播放分鏡腳本的其餘部分之前，重複播放指定主要畫面格之間的間隔。 如果指定了有限重複計數，迴圈一律會播放該次數。 如果 指定UI_ANIMATION_REPEAT_INDEFINITELY (-1) ，迴圈會重複直到腳本結束為止，在此情況下，迴圈的目前反覆專案會完成，而分鏡腳本的其餘部分則會播放。 迴圈無限期的分鏡腳本也會在截斷時結束。
不支援巢狀和重疊迴圈。
主要畫面格代表分鏡腳本內的一段時間，可用來指定轉換的開始或結束時間。 因為主要畫面格可以在轉換結束時新增，所以在腳本播放之前，可能無法得知從分鏡腳本開始的位移。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8、適用於 Windows 7 的 Windows 7 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | uianimation.h |
| Dll | UIAnimation.dll |