共用方式為

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;當不再需要圖示資源時，系統會自動釋放圖示資源。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 commctrl.h
程式庫 Comctl32.lib
Dll Comctl32.dll
API 集合 ext-ms-win-shell-comctl32-init-l1-1-1 (於 Windows 10 10.0.14393 版)