ImageList_LoadImageA-Funktion (commctrl.h)

Erstellt eine Bildliste aus der angegebenen Bitmap.

Syntax

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

Parameter

hi

Typ: HINSTANCE

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

lpbmp

Typ: LPCTSTR

Das zu ladende Image.

Wenn der uFlags-Parameter LR_LOADFROMFILE enthält, ist lpbmp die Adresse einer Zeichenfolge mit NULL-Beendigung, die die Datei benennt, die das zu ladende Image enthält.

Wenn der hi-Parameter nicht NULL ist und LR_LOADFROMFILE nicht angegeben ist, ist lpbmp die Adresse einer Zeichenfolge mit NULL-Beendigung, die den Namen der Imageressource im hi-Modul enthält.

Wenn hiNULL ist und LR_LOADFROMFILE nicht angegeben ist, muss der LOWORD dieses Parameters der Bezeichner eines oem-Images 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.

Wert	Bedeutung
OBM_ für OEM-Bitmaps
OIC_ für OEM-Symbole
OCR_ für OEM-Cursor

cx

Typ: int

Die Breite jedes Bilds. Die Höhe jedes Bilds und die anfängliche Anzahl von Bildern werden von den Dimensionen 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 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, dem angegebenen Cursor oder dem angegebenen Symbol 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. 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 Images angibt. Dieser Parameter muss IMAGE_BITMAP sein, um anzugeben, dass eine Bitmap geladen wird.

Beachten SieImageList_LoadImage nur mit Bitmapdateien verwendet werden kann. Es werden keine anderen Imagetypen unterstützt.

 

Wert	Bedeutung
IMAGE_BITMAP	Lädt eine Bitmap.

uFlags

Typ: UINT

Flags, die angeben, wie das Image geladen werden soll. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

Wert	Bedeutung
LR_CREATEDIBSECTION	Bewirkt, dass die Funktion eine DIB-Abschnittsbit anstelle einer kompatiblen Bitmap zurückgibt, wenn der uType-Parameter IMAGE_BITMAP angibt. LR_CREATEDIBSECTION ist nützlich, um eine Bitmap zu laden, ohne sie den Farben des Anzeigegeräts zuzuordnen.
LR_DEFAULTCOLOR	Verwendet das Farbformat der Anzeige.
LR_DEFAULTSIZE	Verwendet die Breite oder Höhe, die durch die Systemmetrikwerte für Cursor und Symbole angegeben wird, wenn der cx-Parameter auf 0 festgelegt ist. Wenn dieser Wert nicht angegeben und cx auf 0 festgelegt ist, legt die Funktion die Größe auf die in der Ressource angegebene fest. Wenn die Ressource mehrere Bilder enthält, legt die Funktion die Größe des ersten Bilds fest.
LR_LOADFROMFILE	Lädt das Bild aus der durch den lpbmp-Parameter angegebenen Datei.
LR_LOADMAP3DCOLORS	Durchsucht die Farbtabelle für das Bild und ersetzt die folgenden Grautöne durch die entsprechende dreidimensionale Farbe: Dk Grau: RGB(128, 128, 128)COLOR_3DSHADOW Grau: RGB(192, 192, 192)COLOR_3DFACE Lt Grau: RGB(223, 223, 223)COLOR_3DLIGHT Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
LR_LOADTRANSPARENT	Ruft den Farbwert des ersten Pixels im Bild ab und ersetzt den entsprechenden Eintrag in der Farbtabelle durch die Standardfensterfarbe (die COLOR_WINDOW Anzeigefarbe). Alle Pixel im Bild, die diese Farbe verwenden, werden zur Standardfarbe des Fensterwerts. Dieser Wert gilt nur für Bilder, die über eine entsprechende Farbtabelle verfügen. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
LR_MONOCHROME	Lädt das Bild in Schwarzweiß.
LR_SHARED	Gibt das Imagehandle weiter, wenn das Image mehrmals geladen wird. Verwenden Sie diesen Wert nicht für Bilder mit nicht herkömmlichen Größen, die sich nach dem Laden ändern können, oder für Bilder, die aus einer Datei geladen werden.

Rückgabewert

Typ: HIMAGELIST

Gibt das Handle an die Imageliste zurück, wenn dies erfolgreich war, oder andernfalls NULL .

Hinweise

LR_LOADTRANSPARENT lädt das Bild nicht transparent. Es wird eine undurchsichtige Bildliste erstellt, die nur transparent angezeigt wird, da alle Hintergrundpixel in COLOR_WINDOW geändert wurden. Wenn die Bilder über einen Hintergrund gezeichnet werden, der nicht der Farbe COLOR_WINDOW entspricht, 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 erneut laden, um die Farben neu zuzuordnen.

Hinweis

Der commctrl.h-Header definiert ImageList_LoadImage als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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
Bibliothek	Comctl32.lib
DLL	Comctl32.dll

Weitere Informationen

Loadimage