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 删除 hbmImage 和 hbmMask 。
若要使用 IImageList::Replace,请在清单中指定 Comctl32.dll 版本 6。 有关清单的详细信息,请参阅 启用视觉样式。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | commoncontrols.h |
DLL | Comctl32.dll (6.0 或更高版本) |