共用方式為


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_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