IImageList：：ReplaceIcon 方法 (commoncontrols.h)

将图像替换为图标或光标。

语法

HRESULT ReplaceIcon(
  [in]  int   i,
  [in]  HICON hicon,
  [out] int   *pi
);

[in] i

类型： int

一个 int 类型的值，该值包含要替换的图像的索引。如果 i 为 -1，则函数会将图像添加到列表的末尾。

[in] hicon

类型： HICON

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

[out] pi

类型： int*

指向 int 的指针，如果返回成功，则包含图像的索引;否则为 -1。

类型： HRESULT

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

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

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