IDCompositionRectangleClip::SetLeft(float) メソッド (dcomp.h)

クリップ四角形の Left プロパティの値を変更します。 Left プロパティは、クリップ四角形の左上隅の x 座標を指定します。

構文

HRESULT SetLeft(
  [in] float left
);

[in] left

型: float

Left プロパティの新しい値 (ピクセル単位)。このパラメーターの数値の上限は -2^21 から 2^21 です。 API は、この範囲外の数値を受け入れますが、常にこの範囲に固定されます。

型: HRESULT

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

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

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