IUIAnimationVariableIntegerChangeHandler::OnIntegerValueChanged メソッド (uianimation.h)

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

アニメーション変数の値が変更されたときに発生するイベントを処理します。

このメソッドは、更新プログラムを INT32 値として受け取ります。更新プログラムを DOUBLE 値として受信するには、 IUIAnimationVariableChangeHandler::OnValueChanged メソッドを使用します。

構文

HRESULT OnIntegerValueChanged(
  [in] IUIAnimationStoryboard *storyboard,
  [in] IUIAnimationVariable   *variable,
  [in] INT32                  newValue,
  [in] INT32                  previousValue
);

パラメーター

[in] storyboard

variable パラメーターで指定されたアニメーション変数をアニメーション化するストーリーボード。

[in] variable

更新されたアニメーション変数。

[in] newValue

アニメーション変数の新しい値。変数の丸めモードに従って丸められます。

[in] previousValue

アニメーション変数の前の値。変数の丸めモードに従って丸められます。

戻り値

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

注釈

アニメーション変数の丸めモードは、 IUIAnimationVariable::SetRoundingMode メソッドを使用して指定します。

OnIntegerValueChanged イベントは、2.2、2.3、2.4 などの値はすべて同じ整数に丸められるため、 OnValueChanged イベントよりも発生頻度が低くなる可能性があります。

既定では、コールバックメソッドで他のアニメーションメソッドを呼び出すと、呼び出しが失敗し 、UI_E_ILLEGAL_REENTRANCYが返されます。ただし、この既定値には例外があります。 OnIntegerValueChanged から次のメソッドを正常に呼び出すことができます。

要件

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