IImageList::SetBkColor 方法 (commoncontrols.h)

设置图像列表的背景色。 仅当向图像列表添加图标或使用 IImageList::AddMasked 方法添加黑白位图时,此方法才可用。 如果没有蒙板,则会绘制整个图像,并且背景色不可见。

语法

HRESULT SetBkColor(
  [in]  COLORREF clrBk,
  [out] COLORREF *pclr
);

参数

[in] clrBk

类型: COLORREF

要设置的背景色。 如果此参数设置为 CLR_NONE,则使用 掩码以透明方式绘制图像。

[out] pclr

类型: COLORREF*

指向返回时包含上一背景色的 COLORREF 的指针,否则CLR_NONE。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

若要使用 IImageList::SetBkColor,请在清单中指定 Comctl32.dll 版本 6。 有关清单的详细信息,请参阅 启用视觉样式

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 commoncontrols.h
DLL Comctl32.dll (6.0 或更高版本)