ImageList_AddMasked-Funktion (commctrl.h)

  • Artikel

Fügt einer Bildliste ein Bild oder Bilder hinzu, wodurch eine Maske aus der angegebenen Bitmap generiert wird.

Syntax

int ImageList_AddMasked(
  HIMAGELIST himl,
  HBITMAP    hbmImage,
  COLORREF   crMask
);

Parameter

himl

Typ: HIMAGELIST

Ein Handle für die Bildliste.

hbmImage

Typ: HBITMAP

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

crMask

Typ: COLORREF

Die Farbe, die zum Generieren der Maske verwendet wird. Jedes Pixel dieser Farbe in der angegebenen Bitmap wird in Schwarz geändert, und das entsprechende Bit in der Maske ist auf 1 festgelegt. Wenn dieser Parameter CLR_DEFAULT ist, wird die Farbe des Pixels bei (0,0) als Maske verwendet.

Rückgabewert

Typ: int

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

Hinweise

Die funktion ImageList_AddMasked kopiert die Bitmap in eine interne Datenstruktur. Bitmaps mit einer Farbtiefe von mehr als 8 bpp werden nicht unterstützt. Stellen Sie sicher, dass Sie die DeleteObject-Funktion verwenden, um hbmImage nach der Rückgabe der Funktion zu löschen.

Anforderungen

   
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)