IImageList：：ReplaceIcon 方法 (commoncontrols.h)

以圖示或游標取代影像。

語法

HRESULT ReplaceIcon(
  [in]  int   i,
  [in]  HICON hicon,
  [out] int   *pi
);

[in] i

類型： int

int 類型的值，其中包含要取代之影像的索引。如果 i 是 -1，函式會將影像新增至清單結尾。

[in] hicon

類型： HICON

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

[out] pi

類型： int*

int 的指標，如果成功，則會在傳回時包含影像的索引，否則為 -1。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

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

若要使用 IImageList：：ReplaceIcon，請在指令清單中指定 Comctl32.dll 第 6 版。如需指令清單的詳細資訊，請參閱啟用視覺樣式。