iImageList：：AddMasked 方法 (commoncontrols.h)

将一个或多个图像添加到图像列表，从指定的位图生成掩码。

语法

HRESULT AddMasked(
  [in]  HBITMAP  hbmImage,
  [in]  COLORREF crMask,
  [out] int      *pi
);

[in] hbmImage

类型： HBITMAP

包含一个或多个图像的位图的句柄。图像数是从位图的宽度推断出来的。

[in] crMask

类型： COLORREF

用于生成掩码的颜色。指定位图中此颜色的每个像素都更改为黑色，掩码中的相应位设置为 1。如果此参数为CLR_DEFAULT，则使用 (0,0) 的像素颜色作为掩码。

[out] pi

类型： int*

指向 int 的指针，该指针包含返回时第一个新图像的索引（如果成功），否则为 -1。

类型： HRESULT

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

注意将修改在 hbmImage 中传递的位图。

IImageList：：AddMasked 将位图复制到内部数据结构。不支持颜色深度大于 8bpp 的位图。在方法返回后，必须使用 DeleteObject 函数删除 hbmImage 和 crMask 。

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