ImageList_ReplaceIcon 函式 (commctrl.h)

以圖示或游標取代影像。

語法

int ImageList_ReplaceIcon(
  [in] HIMAGELIST himl,
  [in] int        i,
  [in] HICON      hicon
);

參數

[in] himl

類型： HIMAGELIST

影像清單的句柄。

[in] i

類型： int

要取代之影像的索引。 如果 i 是 -1，函式會將影像附加至清單結尾。

[in] hicon

類型： HICON

包含新影像之位圖和遮罩之圖示或游標的句柄。

傳回值

類型： int

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

備註

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

規格需求