ImageList_ReplaceIcon-Funktion (commctrl.h)

Artikel
02/26/2024

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)

Freigeben über