IDCompositionTranslateTransform3D::SetOffsetZ(IDCompositionAnimation*) メソッド (dcomp.h)
3D 変換変換効果の OffsetZ プロパティの値をアニメーション化します。 OffsetZ プロパティは、z 軸に沿って移動する距離を指定します。
構文
HRESULT SetOffsetZ(
[in] IDCompositionAnimation *animation
);
パラメーター
[in] animation
OffsetZ プロパティの値が時間の経過とともにどのように変化するかを決定するアニメーション オブジェクト。 このパラメーターを NULL にすることはできません。
戻り値
種類: HRESULT
関数が成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 DirectComposition エラー コード 」を参照してください。
解説
このメソッドは、指定したアニメーションのコピーを作成します。 このメソッドの呼び出し後に アニメーション パラメーターによって参照されるオブジェクトが変更された場合、このメソッドが再度呼び出されない限り、変更は OffsetZ プロパティに影響しません。 OffsetZ プロパティが以前にアニメーション化されていた場合、このメソッドを呼び出すと、前のアニメーションが新しいアニメーションに置き換えられます。
アニメーションが無効なポインターである場合、または影響を受けるビジュアルを作成したのと同じ IDCompositionDevice インターフェイスによってアニメーションが作成されなかった場合、このメソッドは失敗します。 インターフェイスをカスタム実装にすることはできません。このメソッドでは、Microsoft DirectComposition によって作成されたインターフェイスのみを使用できます。
要件
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dcomp.h |
| Library | Dcomp.lib |
| [DLL] | Dcomp.dll |
関連項目
IDCompositionTranslateTransform3D