IUIAnimationInterpolator2::GetDependencies メソッド (uianimation.h)

  • [アーティクル]

指定されたディメンションについて、 GetDependencies は、 IUIAnimationInterpolator2::SetInitialValueAndVelocity メソッドに渡される初期値または速度に依存する補間器の側面、または IUIAnimationInterpolator2::SetDuration メソッドに渡される期間を取得します。

構文

HRESULT GetDependencies(
  [out] UI_ANIMATION_DEPENDENCIES *initialValueDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *initialVelocityDependencies,
  [out] UI_ANIMATION_DEPENDENCIES *durationDependencies
);

パラメーター

[out] initialValueDependencies

SetInitialValueAndVelocity に渡される初期値に依存する補間器の側面。

[out] initialVelocityDependencies

SetInitialValueAndVelocity に渡される初期速度に依存する補間器の側面。

[out] durationDependencies

SetDuration に渡される期間に依存する補間器の側面。

戻り値

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

注釈

このメソッドは、特定の入力によって影響を受けるカスタム補間器の側面 (値、速度、期間) を識別するために呼び出されます。 これらの各入力について、補間器は次のいずれかを返します。

  • 適用される UI_ANIMATION_DEPENDENCIES のメンバーのビットごとの OR。
  • 入力 に依存するものが何もない場合にUI_ANIMATION_DEPENDENCY_NONEします。
たとえば、次の補間器を考えてみましょう。
  • 最終的な値をパラメーターとして受け入れます。
  • 常にその最終的な値で段階的に停止します。
  • 最終的な値と初期値の差によって決定される期間があります。
この場合、補間器は initialValueDependencies パラメーター UI_ANIMATION_DEPENDENCY_INTERMEDIATE_VALUES|UI_ANIMATION_DURATIONを返す必要があります。 この値は補間器の作成時に設定され、初期値の影響を受けないため、 UI_ANIMATION_DEPENDENCY_FINAL_VALUEを返さないでください。 同様に、曲線の傾きは最終的な値に達したときに常に 0 に定義 されるため、補間器はUI_ANIMATION_DEPENDENCY_FINAL_VELOCITYを返さないでください。

補間器は、正しいフラグセットを返す必要があります。 出力にフラグが存在しない場合、Windows アニメーションでは、対応するパラメーターが補間の結果のその側面に影響しないと見なされます。 たとえば、カスタム補間器に initialVelocityDependencies のUI_ANIMATION_DEPENDENCY_FINAL_VALUEが含まれていない場合、Windows アニメーションでは SetInitialValueAndVelocity を任意の velocity パラメーターで呼び出し、GetFinalValue を呼び出して最終的な値を決定できます。 補間子の GetFinalValue の実装では、遷移の最終値が初期速度に依存しないと補間子が要求しているため、 SetInitialValueAndVelocity に渡された速度パラメーターに関係なく、同じ結果を返す必要があります。

メモdurationDependencies に返されるフラグにUI_ANIMATION_DEPENDENCY_DURATIONが含まれていない場合、SetDuration は補間で呼び出されません。
 

要件

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

こちらもご覧ください

IUIAnimationInterpolator2