IImageList::AddMasked-Methode (commoncontrols.h)

Artikel
02/26/2024

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

Syntax

HRESULT AddMasked(
  [in]  HBITMAP  hbmImage,
  [in]  COLORREF crMask,
  [out] int      *pi
);

Parameter

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

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

[out] pi

Typ: int*

Ein Zeiger auf ein int , das den Index des ersten neuen Bilds enthält, wenn es zurückgegeben wird, wenn es erfolgreich ist, oder andernfalls -1.

Rückgabewert

Typ: HRESULT

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

Hinweise

Hinweis Die in hbmImage übergebene Bitmap wird geändert.

IImageList::AddMasked kopiert die Bitmap in eine interne Datenstruktur. Bitmaps mit einer Farbtiefe von mehr als 8 bpp werden nicht unterstützt. Sie müssen die DeleteObject-Funktion verwenden, um hbmImage und crMask nach der Rückgabe der Methode zu löschen.

Um IImageList::AddMasked 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 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commoncontrols.h
DLL	Comctl32.dll (Version 6.0 oder höher)

Freigeben über