Freigeben über


ImageList_ReplaceIcon-Funktion (commctrl.h)

Ersetzt ein Bild durch ein Symbol oder einen Cursor.

Syntax

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

Parameter

[in] himl

Typ: HIMAGELIST

Ein Handle für die Bildliste.

[in] i

Typ: int

Der Index des zu ersetzenden Bilds. Wenn i -1 ist, fügt die Funktion das Bild an das Ende der Liste an.

[in] hicon

Typ: HICON

Das Handle für das Symbol oder den Cursor, das die Bitmap und die Maske für das neue Bild enthält.

Rückgabewert

Typ: int

Gibt bei erfolgreicher Ausführung den Index des Images zurück, andernfalls -1.

Hinweise

Da das System hicon nicht speichert, können Sie es zerstören, nachdem die Funktion zurückgegeben wird, wenn das Symbol oder der Cursor von der CreateIcon-Funktion erstellt wurde. Sie müssen hicon nicht zerstören, wenn es von der LoadIcon-Funktion geladen wurde. das System gibt eine Symbolressource automatisch frei, wenn sie nicht mehr benötigt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h
Bibliothek Comctl32.lib
DLL Comctl32.dll
APIs ext-ms-win-shell-comctl32-init-l1-1-1 (eingeführt in Windows 10, Version 10.0.14393)