ImageList_ReplaceIcon 函数 (commctrl.h)

用图标或光标替换图像。

语法

int ImageList_ReplaceIcon(
  [in] HIMAGELIST himl,
  [in] int        i,
  [in] HICON      hicon
);

参数

[in] himl

类型： HIMAGELIST

图像列表的句柄。

[in] i

类型： int

要替换的图像的索引。 如果 i 为 -1，则函数会将图像追加到列表末尾。

[in] hicon

类型： HICON

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

返回值

类型： int

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

注解

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

要求