IUIAnimationStoryboard2::AddTransitionBetweenKeyframes メソッド (uianimation.h)

[アーティクル]
08/26/2023

2 つのキーフレーム間の遷移を追加します。

構文

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 エラーコードを返します。

リターンコード	説明
UI_E_TRANSITION_ALREADY_USED	この切り替えは、ストーリーボードに既に追加されているか、再生が完了してリリースされたストーリーボードに追加されています。
UI_E_TRANSITION_ECLIPSED	切り替えは、ストーリーボードの別の切り替えの始まりを食べる可能性があります。
UI_E_START_KEYFRAME_AFTER_END	開始キーフレームは、終了キーフレームの後に発生する可能性があります。

エラーコードの一覧については、「 Windows アニメーションエラーコード」を参照してください。

注釈

このメソッドは、指定した遷移をストーリーボード内の指定された変数に適用し、遷移は指定したキーフレームで開始および終了します。 duration パラメーターを指定して遷移が作成された場合、その継続時間は開始キーフレームと終了キーフレームの間の時間で上書きされます。それ以外の場合、Windows アニメーションは、必要に応じて切り替えを高速化または低速化します。

キーフレームはストーリーボード内の時間を表し、遷移の開始時刻と終了時刻を指定するために使用できます。キーフレームは切り替えの最後に追加できるため、ストーリーボードが再生されるまで、ストーリーボードの先頭からのオフセットが不明な場合があります。

画面切り替えは、再生される順序で追加する必要があります。ストーリーボードの前の遷移が完了する前に遷移の再生が開始される場合があります。その場合、新しい遷移によって見られる初期値と速度は、前の遷移の状態によって決定されます。前の遷移の開始前に遷移を開始することはできません。

要件

要件	値
サポートされている最小のクライアント	Windows 8、Windows 7、および Windows 7 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	uianimation.h
[DLL]	UIAnimation.dll