IImageList：：AddMasked 方法 (commoncontrols.h)

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

語法

HRESULT AddMasked(
  [in]  HBITMAP  hbmImage,
  [in]  COLORREF crMask,
  [out] int      *pi
);

[in] hbmImage

類型： HBITMAP

包含一或多個影像之位圖的句柄。影像數目是從位圖的寬度推斷。

[in] crMask

類型： COLORREF

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

[out] pi

類型： int*

如果成功，則為 int 的指標，其中包含第一個新影像的索引;如果成功，則為 -1。

類型： HRESULT

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

注意傳入 hbmImage 的點陣圖將會修改。

IImageList：：AddMasked 會將點陣圖複製到內部數據結構。不支援色彩深度大於8bpp的點陣圖。您必須使用 DeleteObject 函式，在方法傳回之後刪除 hbmImage 和 crMask 。

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