IImageList::Remove メソッド (commoncontrols.h)

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

構文

HRESULT Remove(
  [in] int i
);

[in] i

型: int

削除するイメージのインデックスを含む int 型の値。このパラメーターが -1 の場合、メソッドはすべてのイメージを削除します。

種類: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

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

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