IUIAnimationVariableIntegerChangeHandler
COM公式ドキュメント
アニメーション変数の更新イベントを処理するためのメソッドを定義します。
解説(Remarks)
OnIntegerValueChanged は、アニメーション変数の値の更新を INT32 値として受け取ります。
値の更新を DOUBLE 値として受け取るには、IUIAnimationVariableChangeHandler::OnValueChanged メソッドを使用します。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
アニメーション変数の値が変化したときに発生するイベントを処理します。(IUIAnimationVariableIntegerChangeHandler.OnIntegerValueChanged)
| storyboard | IUIAnimationStoryboard* | in | variable パラメーターで指定されたアニメーション変数をアニメーション化しているストーリーボード。 |
| variable | IUIAnimationVariable* | in | 更新されたアニメーション変数。 |
| newValue | INT | in | アニメーション変数の新しい値。変数の丸めモードに従って丸められます。 |
| previousValue | INT | in | アニメーション変数の以前の値。変数の丸めモードに従って丸められます。 |
戻り値
メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。エラーコードの一覧については、Windows Animation Error Codes を参照してください。
解説(Remarks)
アニメーション変数の丸めモードは、IUIAnimationVariable::SetRoundingMode メソッドで指定します。
2.2、2.3、2.4 のような値はいずれも同じ整数に丸められるため、OnIntegerValueChanged イベントは OnValueChanged イベントよりも発生頻度が低くなる場合があります。
既定では、コールバックメソッド内から他のアニメーションメソッドを呼び出すと、その呼び出しは失敗し UI_E_ILLEGAL_REENTRANCY が返されます。ただし、この既定の動作には例外があります。次のメソッドは OnIntegerValueChanged から正常に呼び出すことができます。
- IUIAnimationVariable::GetCurrentStoryboard
- IUIAnimationVariable::GetFinalIntegerValue
- IUIAnimationVariable::GetFinalValue
- IUIAnimationVariable::GetIntegerValue
- IUIAnimationVariable::GetPreviousIntegerValue
- IUIAnimationVariable::GetPreviousValue
- IUIAnimationVariable::GetValue
- IUIAnimationManager::GetStoryboardFromTag
- IUIAnimationManager::GetVariableFromTag
- IUIAnimationStoryboard::GetTag
- IUIAnimationVariable::GetTag
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IUIAnimationVariableIntegerChangeHandler "{BB3E1550-356E-44B0-99DA-85AC6017865E}"
#usecom global IUIAnimationVariableIntegerChangeHandler IID_IUIAnimationVariableIntegerChangeHandler "{}"
#comfunc global IUIAnimationVariableIntegerChangeHandler_OnIntegerValueChanged 3 sptr,sptr,int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。