通过

ImageList_AddIcon宏 (commctrl.h)

  • 项目

将图标或光标添加到图像列表。 ImageList_AddIcon 调用 ImageList_ReplaceIcon 函数。

语法

int ImageList_AddIcon(
   HIMAGELIST himl,
   HICON      hicon
);

参数

himl

类型： HIMAGELIST

图像列表的句柄。 如果此参数标识掩码图像列表，则宏将同时复制图标或光标的图像和掩码位图。 如果此参数标识非掩码图像列表，则宏仅复制图像位图。

hicon

类型： HICON

包含新图像的位图和掩码的图标或光标的句柄。

返回值

类型： int

如果成功，则返回图像的索引，否则返回 -1。

注解

由于系统不保存 hicon，因此，如果图标或光标是由 CreateIcon 函数创建的，则可以在宏返回后销毁它。 如果 hicon 是由 LoadIcon 函数加载的，则无需销毁它;当不再需要图标资源时，系统会自动释放该资源。

ImageList_AddIcon宏的定义如下：

#define  ImageList_AddIcon(himl, hicon) ImageList_ReplaceIcon(himl, -1, hicon)

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 commctrl.h