ImageList_AddIcon宏 (commctrl.h)

將圖示或游標新增至影像清單。 ImageList_AddIcon 呼叫 ImageList_ReplaceIcon 函式。

語法

void ImageList_AddIcon(
   himl,
   hicon
);

himl

類型： HIMAGELIST

影像清單的句柄。如果此參數識別遮罩的影像清單，宏會複製圖示或游標的影像和遮罩位圖。如果此參數識別非遮罩影像清單，宏只會複製影像位圖。

hicon

類型： HICON

圖示或游標的句柄，其中包含新影像的點陣圖和遮罩。

類型： int

如果成功，則傳回影像的索引，否則傳回 -1。

因為系統不會儲存 hicon，所以如果 CreateIcon 函式建立圖示或游標，您可以在宏傳回之後終結它。如果 LoadIcon 函式已載入 hicon，您就不需要終結 hicon;當不再需要圖示資源時，系統會自動釋放圖示資源。

ImageList_AddIcon宏的定義如下：

#define  ImageList_AddIcon(himl, hicon) ImageList_ReplaceIcon(himl, -1, hicon)