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 を削除してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commctrl.h
Library Comctl32.lib
[DLL] Comctl32.dll