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 で導入) |