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 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 |
---|---|
|
|
|
|
|
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.
Wert | Bedeutung |
---|---|
|
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.
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
Anforderung | Wert |
---|---|
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
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