Win32 API 日本語リファレンス
ホーム › UI.Animation › IUIAnimationTransition2

IUIAnimationTransition2

COM
📘 Microsoft Learn (日本語) · English
IID62ff9123-a85a-4e9b-a218-435a93e268fd継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

遷移(トランジション)を定義する IUIAnimationTransition インターフェイスを拡張します。IUIAnimationTransition2 の遷移は、指定された次元においてアニメーション変数が時間とともにどのように変化するかを決定します。

メソッド 7

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetDimension(DWORD* dimension)

アニメーション変数に対して遷移が指定されている次元数を取得します。

dimensionDWORD*out次元数。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。エラーコードの一覧については Windows Animation Error Codes を参照してください。

vtbl 4 HRESULT SetInitialValue(DOUBLE value)

遷移の初期値を設定します。

valueDOUBLEin遷移の初期値。

戻り値

成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。エラーコードの一覧については Windows Animation Error Codes を参照してください。

解説(Remarks)

遷移をストーリーボードに追加した後で、このメソッドを呼び出さないでください。

vtbl 5 HRESULT SetInitialVectorValue(DOUBLE* value, DWORD cDimension)

アニメーション変数の指定された各次元について、遷移の初期値を設定します。

valueDOUBLE*in遷移の初期値を格納するベクター(サイズは cDimension)。
cDimensionDWORDin遷移の値が必要な次元数。このパラメーターは value に列挙された値の個数を指定します。

戻り値

成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。エラーコードの一覧については Windows Animation Error Codes を参照してください。

解説(Remarks)

アニメーションマネージャーは、遷移をストーリーボードに追加した後でこのメソッドを呼び出さないでください。

vtbl 6 HRESULT SetInitialVelocity(DOUBLE velocity)

遷移の初期速度を設定します。

velocityDOUBLEin遷移の初期速度。

戻り値

成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。エラーコードの一覧については Windows Animation Error Codes を参照してください。

vtbl 7 HRESULT SetInitialVectorVelocity(DOUBLE* velocity, DWORD cDimension)

アニメーション変数の指定された各次元について、遷移の初期速度を設定します。

velocityDOUBLE*in遷移の初期速度を格納するベクター(サイズは cDimension)。
cDimensionDWORDin遷移の速度が必要な次元数。このパラメーターは velocity に列挙された値の個数を指定します。

戻り値

成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。エラーコードの一覧については Windows Animation Error Codes を参照してください。

vtbl 8 HRESULT IsDurationKnown()

遷移の継続時間が既知かどうかを判定します。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。エラーコードの一覧については Windows Animation Error Codes を参照してください。

解説(Remarks)

遷移が追加されたストーリーボードがスケジュール済み、または再生中の場合、このメソッドを呼び出さないでください。

vtbl 9 HRESULT GetDuration(DOUBLE* duration)

遷移の継続時間を取得します。(IUIAnimationTransition2.GetDuration)

durationDOUBLE*out遷移の継続時間(秒単位)。

戻り値

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。エラーコードの一覧については Windows Animation Error Codes を参照してください。

解説(Remarks)

アプリケーションは通常、このメソッドを呼び出す前に IsDurationKnown メソッドを呼び出す必要があります。

遷移が追加されたストーリーボードがスケジュール済み、または再生中の場合、このメソッドを呼び出さないでください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IUIAnimationTransition2 "{62FF9123-A85A-4E9B-A218-435A93E268FD}"
#usecom global IUIAnimationTransition2 IID_IUIAnimationTransition2 "{}"
#comfunc global IUIAnimationTransition2_GetDimension              3 var
#comfunc global IUIAnimationTransition2_SetInitialValue           4 double
#comfunc global IUIAnimationTransition2_SetInitialVectorValue     5 var,int
#comfunc global IUIAnimationTransition2_SetInitialVelocity        6 double
#comfunc global IUIAnimationTransition2_SetInitialVectorVelocity  7 var,int
#comfunc global IUIAnimationTransition2_IsDurationKnown           8
#comfunc global IUIAnimationTransition2_GetDuration               9 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。