共用方式為

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 。

規格需求

   
最低支援的用戶端 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 版)