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

要件

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