ImageList_LoadBitmap Makro (commctrl.h)

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

Syntax

HIMAGELIST ImageList_LoadBitmap(
   HINSTANCE hi,
   LPCTSTR   lpbmp,
   int       cx,
   int       cGrow,
   COLORREF  crMask
);

Parameter

hi

Typ: HINSTANCE-

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

lpbmp

Typ: LPCTSTR-

Das zu ladende Bild. Wenn der hi-Parameter nichtNULL-ist, ist lpbmp- die Adresse einer null-beendeten Zeichenfolge, die den Namen der Bildressource im hi Modul enthält. Wenn hiNULL-ist, muss die 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 OEM-Bitmap-IDs, die in WINUSER.H definiert sind. Diese Bezeichner weisen das Präfix OBM_ auf.

cx

Typ: int

Die Breite der einzelnen Bilder. Die Höhe der einzelnen Bilder 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 Bildliste mit geänderter Größ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 wird auf 1 festgelegt. Wenn dieser Parameter der wert CLR_NONE ist, wird keine Maske generiert.

Rückgabewert

Typ: HIMAGELIST

Gibt das Handle an die Bildliste zurück, wenn dies erfolgreich ist, oder NULL- andernfalls.

Anforderungen