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 动画 错误代码。

返回代码 说明
UI_E_START_KEYFRAME_AFTER_END
开始关键帧可能出现在结束关键帧之后。
UI_E_END_KEYFRAME_NOT_DETERMINED
在到达开始关键帧时,可能无法确定结束关键帧时间。
UI_E_LOOPS_OVERLAP
情节提要的两个重复部分可能会重叠。

注解

此方法指示情节提要在播放情节提要的其余部分之前重复播放给定关键帧之间的间隔。 如果指定了有限重复计数,循环将始终播放该次数。 如果 指定UI_ANIMATION_REPEAT_INDEFINITELY (-1) ,则循环将重复,直到情节提要结束,在这种情况下,循环的当前迭代完成,情节提要的其余部分将播放。 无限循环的情节提要也会在截断时结束。

不支持嵌套循环和重叠循环。

关键帧表示情节提要中的某个时刻,可用于指定切换的开始或结束时间。 由于关键帧可以在切换结束时添加,因此在播放情节提要之前,它们与情节提要开头的偏移量可能未知。

要求

要求
最低受支持的客户端 Windows 7、Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 uianimation.h
DLL UIAnimation.dll

另请参阅

IUIAnimationStoryboard

IUIAnimationStoryboard::AddKeyframeAfterTransition

IUIAnimationStoryboard::AddKeyframeAtOffset