ImageList_AddIcon Makro (commctrl.h)

Artikel
10/21/2024

Fügt einer Bildliste ein Symbol oder Cursor hinzu. ImageList_AddIcon ruft die funktion ImageList_ReplaceIcon auf.

Syntax

int ImageList_AddIcon(
   HIMAGELIST himl,
   HICON      hicon
);

Parameter

himl

Typ: HIMAGELIST

Ein Handle für die Bildliste. Wenn dieser Parameter eine maskierte Bildliste identifiziert, kopiert das Makro sowohl die Bild- als auch die Masken-Bitmaps des Symbols oder Cursors. Wenn dieser Parameter eine nicht maskierte Bildliste identifiziert, kopiert das Makro nur die Bild-Bitmap.

hicon

Typ: HICON

Ein 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 das Makro 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.

Das makro ImageList_AddIcon wird wie folgt definiert:

#define  ImageList_AddIcon(himl, hicon) ImageList_ReplaceIcon(himl, -1, hicon)

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

Freigeben über