ImageList_LoadBitmap Makro (commctrl.h)

Artikel
08/22/2023

Ruft die funktion ImageList_LoadImage auf, um eine Bildliste aus der angegebenen Bitmapressource zu erstellen.

Syntax

void ImageList_LoadBitmap(
   hi,
   lpbmp,
   cx,
   cGrow,
   crMask
);

Parameter

hi

Typ: HINSTANCE

Ein Handle für die instance, das die Bitmapressource enthält. Dieser Parameter ist NULL , wenn Sie eine OEM-Bitmap laden.

lpbmp

Typ: LPCTSTR

Das zu ladende Image. Wenn der hi-Parameter ungleich NULL ist, ist lpbmp die Adresse einer Zeichenfolge mit NULL-Beendigung, die den Namen der Imageressource im hi-Modul enthält. Wenn hiNULL ist, muss der LOWORD dieses Parameters der Bezeichner einer OEM-Bitmap sein, die geladen werden soll. Verwenden Sie zum Erstellen dieses Werts das MAKEINTRESOURCE-Makro mit einem der in WINUSER.H definierten OEM-Bitmapbezeichner. Diese Bezeichner haben das präfix OBM_.

cx

Typ: int

Die Breite jedes Bilds. Die Höhe jedes Bilds und die anfängliche Anzahl von Bildern werden durch die Abmessungen der angegebenen Bitmap abgeleitet.

cGrow

Typ: int

Die Anzahl der Bilder, um die die Bildliste vergrößert werden kann, wenn das System Platz für neue Bilder schaffen muss. Dieser Parameter stellt die Anzahl der neuen Bilder dar, die die Liste mit der geänderten Bildgröße enthalten kann.

crMask

Typ: COLORREF

Die Farbe, die zum Generieren einer 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 der CLR_NONE Wert ist, wird keine Maske generiert.

Rückgabewert

Keine

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

Share via