ImageList_Remove函数 (commctrl.h)

从图像列表中移除图像。

语法

BOOL ImageList_Remove(
  HIMAGELIST himl,
  int        i
);

参数

himl

类型: HIMAGELIST

图像列表的句柄。

i

类型: int

要移除的图像的索引。 如果此参数为 -1,则 函数将删除所有图像。

返回值

类型: BOOL

如果成功,返回不为零的值;否则返回零。

注解

删除图像时,将调整剩余图像的索引,以便图像索引的范围始终从 0 到比图像列表中的图像数少 1。 例如,如果在索引 0 处删除图像,则图像 1 变为图像 0,图像 2 变为图像 1,依依此。

要求

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

另请参阅

ImageList_RemoveAll