LoadBitmapA-Funktion (winuser.h)

Artikel
03/04/2024

[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)