IDCompositionVisual::SetOffsetX(IDCompositionAnimation*) メソッド (dcomp.h)

このビジュアルの OffsetX プロパティの値を変更します。 OffsetX プロパティは、親ビジュアルを基準にして、x 軸に沿ったビジュアルの新しいオフセットを指定します。

構文

HRESULT SetOffsetX(
  [in] IDCompositionAnimation *animation
);

パラメーター

[in] animation

型: IDCompositionAnimation*

OffsetX プロパティの値が時間の経過とともにどのように変化するかを決定するアニメーション オブジェクト。 このパラメーターを NULL にすることはできません。

戻り値

型: HRESULT

関数が成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 DirectComposition エラー コード 」を参照してください。

解説

このメソッドは、指定したアニメーションのコピーを作成します。 この呼び出しの後に animation パラメーターによって参照される アニメーション オブジェクトが変更された場合、このメソッドが再度呼び出されない限り、変更は OffsetX プロパティに影響しません。 OffsetX プロパティが以前にアニメーション化されていた場合、このメソッドはそのアニメーションを新しいアニメーションに置き換えます。

アニメーションが無効なポインターである場合、またはこのビジュアルを作成したのと同じ IDCompositionDevice インターフェイスによって作成されなかった場合、このメソッドは失敗します。 インターフェイスをカスタム実装にすることはできません。このメソッドでは、Microsoft DirectComposition によって作成されたインターフェイスのみを使用できます。

要件

関連項目

IDCompositionVisual

IDCompositionVisual::SetOffsetY

IDCompositionVisual::SetTransform