ImageList_Remove関数 (commctrl.h)

イメージ リストからイメージを削除します。

構文

BOOL ImageList_Remove(
  HIMAGELIST himl,
  int        i
);

パラメーター

himl

種類: HIMAGELIST

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

i

型: int

削除するイメージのインデックス。 このパラメーターが -1 の場合、関数はすべてのイメージを削除します。

戻り値

種類: BOOL

成功した場合は 0 以外、それ以外の場合は 0 を返します。

解説

イメージが削除されると、残りのイメージのインデックスが調整され、イメージ インデックスの範囲は常に 0 からイメージ リスト内の画像の数より 1 小さくなります。 たとえば、インデックス 0 でイメージを削除すると、イメージ 1 はイメージ 0 になり、イメージ 2 はイメージ 1 になり、次のようになります。

要件

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

関連項目

ImageList_RemoveAll