LoadBitmapA-Funktion (winuser.h)

Artikel
11/20/2024

[LoadBitmap- steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. 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 Instanz des Moduls, dessen ausführbare Datei die zu ladende Bitmap enthält.

[in] lpBitmapName

Ein Zeiger auf eine mit Null beendete 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. Das MAKEINTRESOURCE Makros kann verwendet werden, um diesen Wert zu erstellen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der Handle für die angegebene Bitmap.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-.

Bemerkungen

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 für einen Drucker nicht ausgewählt werden kann. Um eine Bitmap zu laden, die Sie auf 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 auf jedem 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 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 in Verwenden von Menüs.

Anmerkung

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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll
API-Satz	ext-ms-win-ntuser-draw-l1-1-1 (eingeführt in Windows 8.1)