BufferedPaintSetAlpha 函数 （uxtheme.h）

将 alpha 设置为给定矩形中的指定值。 alpha 控制与缓冲区混合到目标设备上下文（DC）时应用的透明度。

Syntax

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

参数

hBufferedPaint

类型： HPAINTBUFFER

缓冲油漆上下文的句柄，通过 BeginBufferedPaint 获取。

[in] prc

类型： const RECT*

指向 RECT 结构的指针，该结构指定要在其中设置 alpha 的矩形。 将此参数设置为 NULL 以指定整个缓冲区。

alpha

类型： BYTE

要设置的 alpha 值。 alpha 值的范围可以是零（完全透明）到 255（完全不透明）。

返回值

类型： HRESULT

如果此函数成功，它将返回 S_OK。 否则，它将返回 HRESULT 错误代码。

注解

此函数设置目标矩形中每个像素的 alpha 值。 传递 alpha 值 255 会使像素完全不透明。 在 uxtheme.h 中定义的 BufferedPaintMakeOpaque 宏将 alpha 值设置为 255。 它通常用于调用 GDI 以绘制到内存缓冲区，然后使其不透明，以便将其绘制在玻璃上。

要求