BufferedPaintSetAlpha 函数 (uxtheme.h)

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

语法

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 会使像素完全不透明。 BufferedPaintMakeOpaque 宏（在 uxtheme.h 中定义）将 alpha 值设置为 255。 它通常用于调用 GDI 以绘制到内存缓冲区，然后使其不透明，以便将其绘制在玻璃上。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	uxtheme.h
DLL	UxTheme.dll