IImageList::Remove 方法 (commoncontrols.h)

从图像列表中移除图像。

语法

HRESULT Remove(
  [in] int i
);

参数

[in] i

类型: int

一个 int 类型的值,该值包含要删除的图像的索引。 如果此参数为 -1,则 方法将删除所有图像。

返回值

类型: HRESULT

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

注解

删除图像时,剩余图像的索引会进行调整,使其始终从零到比图像列表中的图像数少一个。 例如,如果在索引 0 处删除图像,则图像 1 变为图像 0,图像 2 变为图像 1,依此依此。

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

要求

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