IImageList::Replace 方法 (commoncontrols.h)

将图像列表中的图像替换为新图像。

语法

HRESULT Replace(
  [in]           int     i,
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask
);

参数

[in] i

类型: int

一个 int 类型的值,该值包含要替换的图像的索引。

[in] hbmImage

类型: HBITMAP

包含图像的位图的句柄。

[in, optional] hbmMask

类型: HBITMAP

包含掩码的位图的句柄。 如果未将蒙板用于图像列表,则忽略此参数。

返回值

类型: HRESULT

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

注解

IImageList::Replace 将位图复制到内部数据结构。 方法返回后,必须使用 DeleteObject 删除 hbmImagehbmMask

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

要求

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