ImageList_LoadImageW-Funktion (commctrl.h)

Erstellt eine Bildliste aus der angegebenen Bitmap.

Syntax

HIMAGELIST ImageList_LoadImageW(
  HINSTANCE hi,
  LPCWSTR   lpbmp,
  int       cx,
  int       cGrow,
  COLORREF  crMask,
  UINT      uType,
  UINT      uFlags
);

Parameter

hi

Typ: HINSTANCE-

Ein Handle für die Instanz, die die Ressource enthält. Dieser Parameter kann NULL- werden, wenn Sie ein Bild aus einer Datei laden oder eine OEM-Ressource laden.

lpbmp

Typ: LPCTSTR-

Das zu ladende Bild.

Wenn der uFlags Parameter LR_LOADFROMFILE enthält, ist lpbmp- die Adresse einer mit Null beendeten Zeichenfolge, die die Datei mit dem zu ladenden Bild benennt.

Wenn der parameter hi nichtNULL und LR_LOADFROMFILE nicht angegeben ist, ist lpbmp die Adresse einer null-beendeten Zeichenfolge, die den Namen der Bildressource im hi Modul enthält.

Wenn hiNULL- ist und LR_LOADFROMFILE nicht angegeben ist, muss die LOWORD- dieses Parameters der Bezeichner eines OEM-Bilds sein, das geladen werden soll. Verwenden Sie zum Erstellen dieses Werts das MAKEINTRESOURCE Makro mit einem der OEM-Bildbezeichner, die in Winuser.h definiert sind. Diese Bezeichner weisen die folgenden Präfixe 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 Ressource 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, dem Cursor oder symbol 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. Wenn dieser Parameter der CLR_DEFAULT Wert ist, wird die Farbe des Pixels in der oberen linken Ecke des Bilds als Maskenfarbe behandelt.

uType

Typ: UINT-

Ein Flag, das den Typ des zu ladenden Bilds angibt. Dieser Parameter muss IMAGE_BITMAP sein, um anzugeben, dass eine Bitmap geladen wird.

uFlags

Typ: UINT-

Flags, die angeben, wie das Bild geladen werden soll. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.

Rückgabewert

Typ: HIMAGELIST

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

Bemerkungen

LR_LOADTRANSPARENT lädt das Bild nicht transparent. Sie erstellt eine undurchsichtige Bildliste, die nur transparent erscheint, da alle Hintergrundpixel in COLOR_WINDOW geändert wurden. Wenn die Bilder über einem Hintergrund gezeichnet werden, der nicht die Farbe COLOR_WINDOW ist, wird das Bild nicht ordnungsgemäß gezeichnet. Außerdem verwenden LR_LOADTRANSPARENT und LR_LOADMAP3DCOLORS die Systemfarben, die zum Zeitpunkt des Aufrufs ImageList_LoadImage wirksam waren. Wenn sich die Systemfarben anschließend ändern, muss die Anwendung das Bild neu laden, um die Farben neu zuzuordnen.

Anforderungen

Siehe auch

LoadImage-