ImageList_ReplaceIcon-Funktion (commctrl.h)

Ersetzt ein Bild durch ein Symbol oder 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-

Der Ziehpunkt zum Symbol oder Cursor, das die Bitmap und die Maske für das neue Bild enthält.

Rückgabewert

Typ: int

Gibt den Index des Bilds zurück, wenn dies erfolgreich ist, oder -1 andernfalls.

Bemerkungen

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

Anforderungen