IUIAnimationStoryboard::AddTransitionAtKeyframe 方法 (uianimation.h)

添加从指定关键帧开始的转换。

语法

HRESULT AddTransitionAtKeyframe(
  [in] IUIAnimationVariable   *variable,
  [in] IUIAnimationTransition *transition,
  [in] UI_ANIMATION_KEYFRAME  startKeyframe
);

参数

[in] variable

要为其添加切换的动画变量。

[in] transition

要添加的转换。

[in] startKeyframe

指定新转换开始的关键帧。

返回值

如果该方法成功,则它会返回 S_OK。 否则,将返回 HRESULT 错误代码。 有关错误代码列表,请参阅 Windows 动画 错误代码。

返回代码 说明
UI_E_TRANSITION_ALREADY_USED
此切换已添加到情节提要或已添加到已完成播放并已发布的情节提要中。
UI_E_TRANSITION_ECLIPSED
切换可能会让情节提要中另一个过渡的开始黯然失色。

注解

必须按播放顺序添加切换。 切换可能在情节提要中的上一个切换完成之前开始播放,在这种情况下,新切换的初始值和速度由前一个转换的状态决定。 转换不应在上一个转换开始之前开始。

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

要求

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

另请参阅

IUIAnimationStoryboard

IUIAnimationStoryboard::AddKeyframeAfterTransition

IUIAnimationStoryboard::AddKeyframeAtOffset

IUIAnimationStoryboard::AddTransition

IUIAnimationStoryboard::AddTransitionBetweenKeyframes

IUIAnimationTransition

IUIAnimationTransitionLibrary