IUIAnimationTransitionLibrary::CreateAccelerateDecelerateTransition メソッド (uianimation.h)

加速減速遷移を作成します。

構文

HRESULT CreateAccelerateDecelerateTransition(
  [in]  UI_ANIMATION_SECONDS   duration,
  [in]  DOUBLE                 finalValue,
  [in]  DOUBLE                 accelerationRatio,
  [in]  DOUBLE                 decelerationRatio,
  [out] IUIAnimationTransition **transition
);

パラメーター

[in] duration

切り替えの期間。

[in] finalValue

画面切り替えの最後にあるアニメーション変数の値。

[in] accelerationRatio

加速に費やされた時間と期間の比率。

[in] decelerationRatio

時間に対するデクリレートに費やされた時間の比率。

[out] transition

新しい加速減速遷移。

戻り値

メソッドが成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 Windows アニメーション のエラー コード」を参照してください。

解説

加速減速遷移中は、アニメーション変数の速度が上がり、切り替えの間に速度が低下し、指定した値で終了します。 異なる加速度と減速比を指定することで、変数の加速と減速の速度を個別に制御できます。

初期速度がゼロの場合、加速率は変数が加速に費やす期間の割合です。同様に、減速比も同様です。 初期速度が 0 以外の場合、速度が 0 に達してから遷移の終了までの時間の割合です。 加速度比と減速比は、最大 1.0 に合計する必要があります。

次の図は、加速/減速遷移中に初期速度が異なるアニメーション変数に対する影響を示しています。

例

例については、「 ストーリーボードの作成」と「画面切り替えの追加」を参照してください。

要件

関連項目

IUIAnimationTransition

IUIAnimationTransitionLibrary