IImageList::AddMasked-Methode (commoncontrols.h)
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
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) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für