LoadBitmapW-Funktion (winuser.h)
[LoadBitmap ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen LoadImage und DrawFrameControl.]
Die LoadBitmap-Funktion lädt die angegebene Bitmapressource aus der ausführbaren Datei eines Moduls.
Syntax
HBITMAP LoadBitmapW(
[in] HINSTANCE hInstance,
[in] LPCWSTR lpBitmapName
);
Parameter
[in] hInstance
Ein Handle für die instance des Moduls, dessen ausführbare Datei die zu ladende Bitmap enthält.
[in] lpBitmapName
Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen der zu ladenden Bitmapressource enthält. Alternativ kann dieser Parameter aus dem Ressourcenbezeichner im Wort mit niedriger Reihenfolge und null im Wort mit hoher Reihenfolge bestehen. Mit dem MAKEINTRESOURCE-Makro kann dieser Wert erstellt werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für die angegebene Bitmap.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.
Hinweise
Wenn die Bitmap, auf die der parameter lpBitmapName verweist, nicht vorhanden ist oder nicht genügend Arbeitsspeicher zum Laden der Bitmap vorhanden ist, schlägt die Funktion fehl.
LoadBitmap erstellt eine kompatible Bitmap der Anzeige, die nicht für einen Drucker ausgewählt werden kann. Um eine Bitmap zu laden, die Sie in einen Drucker auswählen können, rufen Sie LoadImage auf, und geben Sie LR_CREATEDIBSECTION an, um einen DIB-Abschnitt zu erstellen. Ein DIB-Abschnitt kann für jedes Gerät ausgewählt werden.
Eine Anwendung kann die LoadBitmap-Funktion verwenden, um auf vordefinierte Bitmaps zuzugreifen. Hierzu muss die Anwendung den hInstance-Parameter auf NULL und den lpBitmapName-Parameter auf einen der folgenden Werte festlegen.
Bitmapname | Bitmapname |
---|---|
OBM_BTNCORNERS | OBM_OLD_RESTORE |
OBM_BTSIZE | OBM_OLD_RGARROW |
OBM_CHECK | OBM_OLD_UPARROW |
OBM_CHECKBOXES | OBM_OLD_ZOOM |
OBM_CLOSE | OBM_REDUCE |
OBM_COMBO | OBM_REDUCED |
OBM_DNARROW | OBM_RESTORE |
OBM_DNARROWD | OBM_RESTORED |
OBM_DNARROWI | OBM_RGARROW |
OBM_LFARROW | OBM_RGARROWD |
OBM_LFARROWD | OBM_RGARROWI |
OBM_LFARROWI | OBM_SIZE |
OBM_MNARROW | OBM_UPARROW |
OBM_OLD_CLOSE | OBM_UPARROWD |
OBM_OLD_DNARROW | OBM_UPARROWI |
OBM_OLD_LFARROW | OBM_ZOOM |
OBM_OLD_REDUCE | OBM_ZOOMD |
Bitmapnamen, die mit OBM_OLD beginnen, stellen Bitmaps dar, die von 16-Bit-Versionen von Windows vor 3.0 verwendet wurden.
Damit eine Anwendung eine der OBM_ Konstanten verwenden kann, muss die KONSTANTE OEMRESOURCE definiert werden, bevor die Windows.h-Headerdatei enthalten ist.
Die Anwendung muss die DeleteObject-Funktion aufrufen, um jedes Bitmaphandle zu löschen, das von der LoadBitmap-Funktion zurückgegeben wird.
Beispiele
Ein Beispiel finden Sie unter Beispiel für Menu-Item Bitmaps unter Verwenden von Menüs.
Hinweis
Der winuser.h-Header definiert LoadBitmap 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 nicht codierungsneutralem Code 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 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winuser.h (einschließlich Windows.h) |
Bibliothek | User32.lib |
DLL | User32.dll |
APIs | ext-ms-win-ntuser-draw-l1-1-1 (eingeführt in Windows 8.1) |
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