ImageList_AddMasked 函式 (commctrl.h)

將影像或影像新增至影像清單，從指定的點陣圖產生遮罩。

語法

int ImageList_AddMasked(
  HIMAGELIST himl,
  HBITMAP    hbmImage,
  COLORREF   crMask
);

參數

himl

類型： HIMAGELIST

影像清單的控制碼。

hbmImage

類型： HBITMAP

包含一或多個影像之點陣圖的控制碼。 影像數目是從點陣圖的寬度推斷。

crMask

類型： COLORREF

用來產生遮罩的色彩。 指定點陣圖中此色彩的每個圖元都會變更為黑色，遮罩中的對應位會設定為 1。 如果此參數CLR_DEFAULT，則 (0，0) 的圖元色彩會當做遮罩使用。

傳回值

類型： int

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

備註

ImageList_AddMasked函式會將點陣圖複製到內部資料結構。 不支援色彩深度大於 8bpp 的點陣圖。 請務必使用 DeleteObject 函式在函式傳回之後刪除 hbmImage 。

規格需求