IUIAnimationStoryboard：：AddTransitionAtKeyframe 方法 (uianimation.h)

發行項
08/26/2023

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

語法

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

參數

[in] variable

要加入轉換的動畫變數。

[in] transition

要加入的轉換。

[in] startKeyframe

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

傳回值

如果方法成功，它會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。如需錯誤碼的清單，請參閱 Windows 動畫錯誤碼。

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

備註

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

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

規格需求


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