ImageList_Add-Funktion (commctrl.h)

Artikel
02/24/2024

Fügt einer Bildliste ein Bild oder Bilder hinzu.

Syntax

int ImageList_Add(
  [in]           HIMAGELIST himl,
  [in]           HBITMAP    hbmImage,
  [in, optional] HBITMAP    hbmMask
);

Parameter

[in] himl

Typ: HIMAGELIST

Ein Handle für die Bildliste.

[in] hbmImage

Typ: HBITMAP

Ein Handle für die Bitmap, die das Bild oder die Bilder enthält. Die Anzahl der Bilder wird aus der Breite der Bitmap abgeleitet.

[in, optional] hbmMask

Typ: HBITMAP

Ein Handle für die Bitmap, die die Maske enthält. Wenn keine Maske mit der Bildliste verwendet wird, wird dieser Parameter ignoriert. Dieser Parameter kann NULL sein.

Rückgabewert

Typ: int

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

Hinweise

Die funktion ImageList_Add kopiert die Bitmap in eine interne Datenstruktur. Stellen Sie sicher, dass Sie die DeleteObject-Funktion verwenden, um hbmImage und hbmMask zu löschen, nachdem die Funktion zurückgegeben wurde.

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

Share via