Share via

ImageList_ReplaceIcon 関数 (commctrl.h)

  • [アーティクル]

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

構文

int ImageList_ReplaceIcon(
  [in] HIMAGELIST himl,
  [in] int        i,
  [in] HICON      hicon
);

パラメーター

[in] himl

種類: HIMAGELIST

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

[in] i

型: int

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

[in] hicon

種類: HICON

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

戻り値

型: int

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

注釈

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

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commctrl.h
Library Comctl32.lib
[DLL] Comctl32.dll
API セット ext-ms-win-shell-comctl32-init-l1-1-1 (Windows 10 バージョン 10.0.14393 で導入)