ImageList_Replace函式 (commctrl.h)

以新的影像取代影像清單中的影像。

語法

BOOL ImageList_Replace(
  HIMAGELIST himl,
  int        i,
  HBITMAP    hbmImage,
  HBITMAP    hbmMask
);

參數

himl

類型： HIMAGELIST

影像清單的控制碼。

i

類型： int

要取代之影像的索引。

hbmImage

類型： HBITMAP

包含影像之點陣圖的控制碼。

hbmMask

類型： HBITMAP

包含遮罩之點陣圖的控制碼。 如果未搭配影像清單使用遮罩，則會忽略此參數。

傳回值

類型： BOOL

如果成功，則傳回非零，否則傳回零。

備註

ImageList_Replace函式會將點陣圖複製到內部資料結構。 請務必使用 DeleteObject 函式，在函式傳回之後刪除 hbmImage 和 hbmMask 。

規格需求