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 。