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 Vista 的 Windows 7、Windows Vista 和平臺更新 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	uianimation.h
Dll	UIAnimation.dll