ImageList_AddIcon マクロ (commctrl.h)

アイコンまたはカーソルをイメージ リストに追加します。 ImageList_AddIconは、ImageList_ReplaceIcon関数を呼び出します。

構文

int ImageList_AddIcon(
   HIMAGELIST himl,
   HICON      hicon
);

パラメーター

himl

種類: HIMAGELIST

イメージ リストへのハンドル。 このパラメーターがマスクされたイメージ リストを識別する場合、マクロはアイコンまたはカーソルのイメージ ビットマップとマスク ビットマップの両方をコピーします。 このパラメーターがマスクされていないイメージ リストを識別する場合、マクロはイメージ ビットマップのみをコピーします。

hicon

種類: HICON

新しいイメージのビットマップとマスクを含むアイコンまたはカーソルへのハンドル。

戻り値

型: int

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

注釈

システムは hicon を保存しないため、アイコンまたはカーソルが CreateIcon 関数によって作成された場合にマクロが戻った後に破棄できます。 LoadIcon 関数によって読み込まれた場合、hicon を破棄する必要はありません。不要になったアイコン リソースは、システムによって自動的に解放されます。

ImageList_AddIcon マクロは次のように定義されます。

#define  ImageList_AddIcon(himl, hicon) ImageList_ReplaceIcon(himl, -1, hicon)

要件