Freigeben über


CBitmap::CreateBitmap

Initialisiert eine Speicherbitmap geräteabhängige, die die angegebene Breite, Höhe und das Bitmuster verfügt.

BOOL CreateBitmap(
   int nWidth,
   int nHeight,
   UINT nPlanes,
   UINT nBitcount,
   const void* lpBits 
);

Parameter

  • nWidth
    Gibt die Breite (in Pixel) der Bitmaps an.

  • nHeight
    Gibt die Höhe (in Pixel) der Bitmaps an.

  • nPlanes
    Gibt die Anzahl der Farbenebenen in der Bitmap an.

  • nBitcount
    Gibt die Anzahl der Farbbits pro Anzeigenpixel an.

  • lpBits
    Zeigt auf einem Bytearray, das die ursprünglichen Bit-Übersichtsbitwerte enthält.Wenn es NULL ist, wird der neue Bitmap nicht initialisiert ist fehlgeschlagen.

Rückgabewert

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

Hinweise

Eine Farbenbitmap entweder nPlanes oder nBitcount-Parameter sollten. auf 1 festgelegt werden.Wenn beide Parameter auf 1 festgelegt ist, erstellt CreateBitmap eine monochrome Bitmap.

Obwohl eine Bitmap nicht für ein Anzeigegerät direkt ausgewählt werden kann, kann sie als die aktuelle Bitmap für einen "Speichergerätekontext" ausgewählt werden, indem CDC::SelectObject verwendet und jedes kompatiblen Gerätekontext kopiert werden, indem die CDC::BitBlt-Funktion verwendet.

Wenn Sie mit dem CBitmap-Objekt beenden, die durch die CreateBitmap-Funktion erstellt wird, wählen Sie zuerst die Bitmap aus dem Gerätekontext out aus, und deaktivieren Sie das CBitmap-Objekt.

Weitere Informationen finden Sie in der Beschreibung des bmBits Felds in der BITMAP-Struktur.Die BITMAP-Struktur wird unter der CBitmap::CreateBitmapIndirect-Memberfunktion beschrieben.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CBitmap-Klasse

Hierarchien-Diagramm

CDC::SelectObject

CGdiObject::DeleteObject

CDC::BitBlt

CreateBitmap