LoadBitmapA-Funktion (winuser.h)
[LoadBitmap ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. 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 LoadBitmapA(
[in] HINSTANCE hInstance,
[in] LPCSTR 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-endende Zeichenfolge, die den Namen der zu ladenden Bitmapressource enthält. Alternativ kann dieser Parameter aus dem Ressourcenbezeichner im Wort mit niedriger Ordnung und null im Wort mit hoher Ordnung bestehen. Das MAKEINTRESOURCE-Makro kann verwendet werden, um diesen Wert zu erstellen.
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 lpBitmapName-Parameter 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. Dazu 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 werden.
Damit eine Anwendung eine der OBM_ Konstanten verwendet, muss die Konstante OEMRESOURCE definiert werden, bevor die Windows.h-Headerdatei eingeschlossen wird.
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 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 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (windows.h einschließen) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-draw-l1-1-1 (eingeführt in Windows 8.1) |