IUIAnimationStoryboard：：AddTransitionBetweenKeyframes 方法 (uianimation.h)

發行項
08/26/2023

在兩個主要畫面格之間加入轉換。

語法

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

參數

[in] variable

要加入轉換的動畫變數。

[in] transition

要加入的轉換。

[in] startKeyframe

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

[in] endKeyframe

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

傳回值

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

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

備註

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

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

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

需求


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