IUIAnimationStoryboard2：：AddTransitionAtKeyframe 方法 (uianimation.h)

發行項
03/03/2024

加入從指定之主要畫面格開始的轉換。

語法

HRESULT AddTransitionAtKeyframe(
  [in] IUIAnimationVariable2   *variable,
  [in] IUIAnimationTransition2 *transition,
  [in] UI_ANIMATION_KEYFRAME   startKeyframe
);

參數

[in] variable

要加入轉換的動畫變數。

[in] transition

要加入的轉換。

[in] startKeyframe

指定新轉換開頭的主要畫面格。

傳回值

如果此方法成功，則會傳回S_OK。否則，它會傳回 HRESULT 錯誤碼。

傳回碼	Description
UI_E_TRANSITION_ALREADY_USED	此轉換已新增至分鏡腳本，或已新增至已完成播放並發行的分鏡腳本。
UI_E_TRANSITION_ECLIPSED	轉換可能會讓分鏡腳本中另一個轉換的開頭 Eclipse。

如需錯誤碼的清單，請參閱 Windows 動畫錯誤碼。

備註

轉換必須依播放順序新增。轉換可能會在腳本中的先前轉換完成之前開始播放，在此情況下，新轉換所看到的初始值和速度取決於前一個轉換的狀態。轉換不應該在先前轉換的開頭之前開始。

主要畫面格代表分鏡腳本內的一段時間，可用來指定轉換的開始和結束時間。因為主要畫面格可以在轉換結束時新增，所以在腳本播放之前，可能不知道其與分鏡腳本開頭的位移。

規格需求

需求	值
最低支援的用戶端	適用於 Windows 7 的 Windows 8、Windows 7 和平臺更新 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	uianimation.h
Dll	UIAnimation.dll