IImageList：：Add 方法 (commoncontrols.h)

向图像列表添加图像。

语法

HRESULT Add(
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask,
  [out]          int     *pi
);

[in] hbmImage

类型： HBITMAP

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

[in, optional] hbmMask

类型： HBITMAP

包含掩码的位图的句柄。如果未将蒙板用于图像列表，则忽略此参数。

[out] pi

类型： int*

此方法返回时，包含指向第一个新图像的索引的指针。如果方法无法成功添加新映像，则此值为 -1。

类型： HRESULT

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

IImageList：：Add 将位图复制到内部数据结构。方法返回后，必须使用 DeleteObject 函数删除 hbmImage 和 hbmMask 。

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