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 を使用するには、マニフェスト Comctl32.dll バージョン 6 を指定します。マニフェストの詳細については、「ビジュアルスタイルの有効化」を参照してください。