IUIAnimationStoryboard：：AddKeyframeAtOffset 方法 (uianimation.h)

项目
08/26/2023

在现有关键帧的指定偏移量处添加关键帧。

语法

HRESULT AddKeyframeAtOffset(
  [in]  UI_ANIMATION_KEYFRAME existingKeyframe,
  [in]  UI_ANIMATION_SECONDS  offset,
  [out] UI_ANIMATION_KEYFRAME *keyframe
);

参数

[in] existingKeyframe

现有关键帧。若要在与情节提要开头的偏移量处添加关键帧，请使用特殊关键帧 UI_ANIMATION_KEYFRAME_STORYBOARD_START。

[in] offset

与要添加新关键帧的现有关键帧的偏移量。

[out] keyframe

要添加的关键帧。

返回值

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

注解

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

示例

以下代码在情节提要开头的关键帧的固定偏移量为 0.3 秒处添加关键帧。

const UI_ANIMATION_SECONDS offset = 0.3;

UI_ANIMATION_KEYFRAME keyframe1;
hr = pStoryboard->AddKeyframeAtOffset(
       UI_ANIMATION_KEYFRAME_STORYBOARD_START,
       offset,
       &keyframe1
);

要求


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