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 函数删除 hbmImagehbmMask

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

要求

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