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 動畫錯誤 碼。
傳回碼 | Description |
---|---|
|
開始主要畫面格可能會在結束主要畫面格之後發生。 |
|
當到達開始主要畫面格時,可能無法判斷結束主要畫面格時間。 |
|
分鏡腳本的兩個重複部分可能會重疊。 |
備註
此方法會指示分鏡腳本在播放分鏡腳本的其餘部分之前,重複播放指定主要畫面格之間的間隔。 如果指定了有限重複計數,迴圈一律會播放該次數。 如果 指定UI_ANIMATION_REPEAT_INDEFINITELY (-1) ,迴圈會重複直到腳本結束為止,在此情況下,迴圈的目前反覆專案會完成,而分鏡腳本的其餘部分則會播放。 迴圈無限期的分鏡腳本也會在截斷時結束。
不支援巢狀和重疊迴圈。
主要畫面格代表分鏡腳本內的一段時間,可用來指定轉換的開始或結束時間。 因為主要畫面格可以在轉換結束時新增,所以在腳本播放之前,可能無法得知從分鏡腳本開始的位移。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows Vista 的 Windows 7、Windows Vista 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | uianimation.h |
Dll | UIAnimation.dll |