IImageList::Add-Methode (commoncontrols.h)

Fügt einer Bildliste ein Bild oder Bilder hinzu.

Syntax

HRESULT Add(
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask,
  [out]          int     *pi
);

Parameter

[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.

[out] pi

Typ: int*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf den Index des ersten neuen Bilds. Wenn die Methode das neue Image nicht erfolgreich hinzufügen kann, ist dieser Wert -1.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

IImageList::Add kopiert die Bitmap in eine interne Datenstruktur. Sie müssen die DeleteObject-Funktion verwenden, um hbmImage und hbmMask nach der Rückgabe der Methode zu löschen.

Um IImageList::Add zu verwenden, geben Sie Comctl32.dll Version 6 im Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commoncontrols.h
DLL	Comctl32.dll (Version 6.0 oder höher)