ImageList_Add 函数 (commctrl.h)

向图像列表添加图像。

语法

int ImageList_Add(
  [in]           HIMAGELIST himl,
  [in]           HBITMAP    hbmImage,
  [in, optional] HBITMAP    hbmMask
);

[in] himl

类型： HIMAGELIST

图像列表的句柄。

[in] hbmImage

类型： HBITMAP

包含图像或图像的位图的句柄。图像数是从位图的宽度推断出来的。

[in, optional] hbmMask

类型： HBITMAP

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

类型： int

如果成功，则返回第一个新映像的索引，否则返回 -1。

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