IDCompositionMatrixTransform3D::SetMatrixElement(int,int,IDCompositionAnimation*) メソッド (dcomp.h)
この 3D 変換のマトリックスの 1 つの要素の値をアニメーション化します。
構文
HRESULT SetMatrixElement(
[in] int row,
[in] int column,
[in] IDCompositionAnimation *animation
);
パラメーター
[in] row
型: int
変更する要素の行インデックス。 この値は、0 ~ 3 の範囲にする必要があります。
[in] column
型: int
変更する要素の列インデックス。 この値は、0 ~ 3 の範囲にする必要があります。
[in] animation
指定した要素の値が時間の経過に伴ってどのように変化するかを表すアニメーション。 このパラメーターを NULL にすることはできません。
戻り値
型: HRESULT
関数が成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 DirectComposition エラー コード 」を参照してください。
注釈
このメソッドは、指定したアニメーションのコピーを作成します。 このメソッドの呼び出し後に アニメーション パラメーターによって参照されるオブジェクトが変更された場合、このメソッドが再度呼び出されない限り、変更は指定された要素に影響しません。 指定した要素が以前にアニメーション化されていた場合、このメソッドを呼び出すと、前のアニメーションが新しいアニメーションに置き換えられます。
アニメーションが無効なポインターである場合、または影響を受ける変換と同じ IDCompositionDevice インターフェイスによって作成されなかった場合、このメソッドは失敗します。 インターフェイスをカスタム実装にすることはできません。このメソッドでは、Microsoft DirectComposition によって作成されたインターフェイスのみを使用できます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | dcomp.h |
Library | Dcomp.lib |
[DLL] | Dcomp.dll |