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。 有关清单的详细信息,请参阅 启用视觉样式。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | commoncontrols.h |
DLL | Comctl32.dll (6.0 或更高版本) |