IUIAnimationStoryboard2：：AddTransitionBetweenKeyframes 方法 (uianimation.h)

發行項
03/13/2024

新增兩個主要畫面格之間的轉換。

語法

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

參數

[in] variable

要加入轉換的動畫變數。

[in] transition

要加入的轉換。

[in] startKeyframe

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

[in] endKeyframe

指定新轉換結尾的主要畫面格。 endKeyframe 不得早於 startKeyframe 出現在分鏡腳本中。

傳回值

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

傳回碼	Description
UI_E_TRANSITION_ALREADY_USED	此轉換已新增至分鏡腳本，或已新增至已完成播放並發行的分鏡腳本。
UI_E_TRANSITION_ECLIPSED	轉換可能會讓分鏡腳本中另一個轉換的開頭 Eclipse。
UI_E_START_KEYFRAME_AFTER_END	啟動主要畫面格可能會在結束主要畫面格之後發生。

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

備註

這個方法會將指定的轉換套用至分鏡腳本中的指定變數，轉換從指定的主要畫面格開始和結束。如果使用指定的持續時間參數建立轉換，則會以開始和結束主要畫面格之間的時間持續時間覆寫該持續時間。否則，Windows 動畫會視需要加速或減緩轉換速度。

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

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

規格需求

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