共用方式為

ImageList_AddIcon宏 (commctrl.h)

  • 發行項

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

語法

int ImageList_AddIcon(
   HIMAGELIST himl,
   HICON      hicon
);

參數

himl

類型： HIMAGELIST

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

hicon

類型： HICON

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

傳回值

類型： int

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

備註

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

ImageList_AddIcon宏的定義如下：

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

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 commctrl.h