IUIAnimationInterpolator::SetDuration メソッド (uianimation.h)

切り替えの期間を設定します。

構文

HRESULT SetDuration(
  [in] UI_ANIMATION_SECONDS duration
);

パラメーター

[in] duration

切り替えの期間。

戻り値

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

注釈

Windows アニメーションは、GetDependencies メソッドを呼び出した後にのみこのメソッドを呼び出し、その呼び出しが durationDependencies フラグの 1 つとしてUI_ANIMATION_DEPENDENCY_DURATIONを返す場合にのみ呼び出します。

通常、期間の依存関係を持つ補間子には、 関連付けられている IUIAnimationTransitionFactory の作成方法に duration パラメーターがあります。 補間子は、最初に初期化されたときの期間を格納し、 SetDuration が呼び出されたときに上書きする必要があります。

Windows アニメーションは常に SetInitialValueAndVelocity メソッドを呼び出して、SetDuration を呼び出す前に初期値とベロシティを設定するため、カスタム補間子は初期値とベロシティが設定されているかどうかをチェックする必要はありません。

Windows アニメーションでは、パラメーターが異なる SetInitialValueAndVelocity と SetDuration を複数回呼び出すことができます。 インターポレーターは内部状態をキャッシュしてパフォーマンスを向上させることができますが、 SetInitialValueAndVelocity が呼び出されるたびにこのキャッシュされた状態を更新し、 SetDuration の後続の呼び出しの結果に更新された状態が反映されるようにする必要があります。

要件

こちらもご覧ください

IUIAnimationInterpolator

UI_ANIMATION_DEPENDENCIES

UI_ANIMATION_SECONDS