BufferedPaintSetAlpha 関数 (uxtheme.h)

指定した四角形の指定した値にアルファを設定します。 アルファは、バッファーをターゲット デバイス コンテキスト (DC) にブレンドするときに適用される透過性の量を制御します。

構文

HRESULT BufferedPaintSetAlpha(
       HPAINTBUFFER hBufferedPaint,
  [in] const RECT   *prc,
       BYTE         alpha
);

パラメーター

hBufferedPaint

種類: HPAINTBUFFER

BeginBufferedPaint を介して取得されたバッファー処理されたペイント コンテキストのハンドル。

[in] prc

型: const RECT*

アルファを設定する四角形を指定する RECT 構造体へのポインター。 バッファー全体を指定するには、このパラメーターを NULL に設定します。

alpha

型: BYTE

設定するアルファ値。 アルファ値の範囲は 0 (完全に透明) から 255 (完全に不透明) です。

戻り値

種類: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この関数は、ターゲット四角形の各ピクセルのアルファ値を設定します。 アルファ値 255 を渡すと、ピクセルが完全に不透明になります。 uxtheme.h で定義されている BufferedPaintMakeOpaque マクロは、アルファ値を 255 に設定します。 通常、GDI を呼び出してメモリ バッファーに描画し、ガラスに描画するために不透明にするために使用されます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	uxtheme.h
[DLL]	UxTheme.dll