ImageList_Replace 函数 (commctrl.h)

  • 项目

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

语法

BOOL ImageList_Replace(
  HIMAGELIST himl,
  int        i,
  HBITMAP    hbmImage,
  HBITMAP    hbmMask
);

参数

himl

类型： HIMAGELIST

图像列表的句柄。

i

类型： int

要替换的图像的索引。

hbmImage

类型： HBITMAP

包含图像的位图的句柄。

hbmMask

类型： HBITMAP

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

返回值

类型： BOOL

如果成功，返回不为零的值；否则返回零。

注解

ImageList_Replace函数将位图复制到内部数据结构。 请务必在函数返回后使用 DeleteObject 函数删除 hbmImage 和 hbmMask 。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 commctrl.h
Library Comctl32.lib
DLL Comctl32.dll