IDCompositionTranslateTransform::SetOffsetX(float) メソッド (dcomp.h)

2D 変換変換の OffsetX プロパティの値を変更します。 OffsetX プロパティは、x 軸に沿って移動する距離を指定します。

構文

HRESULT SetOffsetX(
  [in] float offsetX
);

[in] offsetX

型: float

x 軸に沿って移動する距離 (ピクセル単位)。

種類: HRESULT

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

このメソッドはアフィン変換を実行します。この変換は、すべてのポイントを同じ方向に固定距離で移動します。これは、座標空間の原点をシフトするのと似ています。

offsetX パラメーターが NaN、正の無限大、または負の無限大である場合、このメソッドは失敗します。

OffsetX プロパティが以前にアニメーション化されていた場合、このメソッドはアニメーションを削除し、OffsetX プロパティを指定した静的値に設定します。