IDCompositionEffectGroup::SetOpacity(float) メソッド (dcomp.h)

Opacity プロパティの値を変更します。

構文

HRESULT SetOpacity(
  [in] float opacity
);

[in] opacity

型: float

Opacity プロパティの新しい値。

型: HRESULT

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

不透明度は、0 以下のすべての値に対して完全に透明であると解釈され、1 以上のすべての値に対して完全に不透明と解釈されます。 0 ~ 1 の値はすべて、部分的な不透明度を表します。

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

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