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

画像をアイコンまたはカーソルに置き換えます。

構文

HRESULT ReplaceIcon(
  [in]  int   i,
  [in]  HICON hicon,
  [out] int   *pi
);

パラメーター

[in] i

型: int

置換するイメージのインデックスを含む int 型の値。 i が -1 の場合、関数はリストの末尾にイメージを追加します。

[in] hicon

種類: HICON

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

[out] pi

型: int*

成功した場合は戻り時にイメージのインデックスを格納する int へのポインター。それ以外の場合は -1。

戻り値

型: HRESULT

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

注釈

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

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

要件

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