IImageList：：Add 方法 (commoncontrols.h)

將影像或影像新增至影像清單。

語法

HRESULT Add(
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask,
  [out]          int     *pi
);

[in] hbmImage

類型： HBITMAP

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

[in, optional] hbmMask

類型： HBITMAP

包含遮罩之位圖的句柄。如果未搭配影像清單使用遮罩，則會忽略此參數。

[out] pi

類型： int*

當這個方法傳回時，會包含第一個新影像索引的指標。如果方法無法成功新增映像，這個值會是 -1。

類型： HRESULT

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

IImageList：：Add 會將點陣圖複製到內部數據結構。您必須使用 DeleteObject 函式，在方法傳回之後刪除 hbmImage 和 hbmMask 。

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