CBitmap::LoadBitmap

Artikel
02/26/2013

Lädt die Bitmapressource, die von lpszResourceName Namen oder durch die ID-Nummer in nIDResource der ausführbaren Datei der Anwendung identifiziert ist.

BOOL LoadBitmap(
   LPCTSTR lpszResourceName 
);
BOOL LoadBitmap(
   UINT nIDResource 
);

Parameter

lpszResourceName
Zeigt auf eine auf NULL endende Zeichenfolge, die den Namen der Bitmapressource enthält.
nIDResource
Gibt die Ressourcen-ID-Zahl der Bitmapressource an.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Hinweise

Die geladene Bitmap wird dem CBitmap-Objekt angefügt.

Wenn die Bitmap, die von lpszResourceName identifiziert wird, nicht vorhanden ist, oder wenn nicht genügend Arbeitsspeicher vorhanden ist, um die Bitmaps zu laden, Funktionsrückgaben 0.

Sie können die CGdiObject::DeleteObject-Funktion verwenden, um die Bitmap zu löschen, die von der Funktion LoadBitmap geladen wird, oder der CBitmap Destruktor löscht das Objekt.

Vorsicht
Bevor Sie das Objekt löschen, stellen Sie sicher, dass er nicht in einen Gerätekontext ausgewählt ist.

Die folgenden Bitmaps wurden zu Windows-Versionen 3,1 und höher hinzugefügt:

OBM_UPARRROWIOBM_DNARROWIOBM_RGARROWIOBM_LFARROWI

Diese Bitmaps werden nicht in den Gerätetreibern für Windows-Versionen 3,0 und früher gefunden.Eine vollständige Liste von Bitmaps und Anzeige von ihrer Darstellung, finden Sie unter Windows SDK.