ImageList_Add関数 (commctrl.h)

イメージまたはイメージをイメージリストに追加します。

構文

int ImageList_Add(
  [in]           HIMAGELIST himl,
  [in]           HBITMAP    hbmImage,
  [in, optional] HBITMAP    hbmMask
);

[in] himl

種類: HIMAGELIST

イメージリストへのハンドル。

[in] hbmImage

種類: HBITMAP

イメージまたはイメージを含むビットマップのハンドル。イメージの数は、ビットマップの幅から推論されます。

[in, optional] hbmMask

種類: HBITMAP

マスクを含むビットマップのハンドル。イメージリストでマスクが使用されていない場合、このパラメーターは無視されます。このパラメーターは、NULL でもかまいません。

型: int

成功した場合は最初の新しいイメージのインデックスを返し、それ以外の場合は -1 を返します。

ImageList_Add関数は、ビットマップを内部データ構造にコピーします。 DeleteObject 関数を使用して、関数が戻った後に hbmImage と hbmMask を削除してください。