Freigeben über


CBitmap::CreateCompatibleBitmap

Initialisiert eine Bitmap, die mit dem Gerät kompatibel ist, das durch pDC angegeben wird.

BOOL CreateCompatibleBitmap( 
   CDC* pDC, 
   int nWidth, 
   int nHeight  
);

Parameter

  • pDC
    Gibt den Gerätekontext an.

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

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

Rückgabewert

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

Hinweise

Die Bitmap hat dieselbe Anzahl von Farbenebenen oder gleicher Bit pro Pixel Format wie der angegebene Gerätekontext. Sie kann als die aktuelle Bitmap für jedes Speichergerät ausgewählt werden, das mit dem kompatibel ist, das durch pDC angegeben wird.

Wenn pDC ein Speichergerätekontext ist, verfügt die zurückgegebene Bitmap das Format, das die aktuell ausgewählte Bitmap in diesem Gerätekontext. Ein "Speichergerätekontext" ist ein Speicherblock, der eine Anzeigeoberfläche darstellt. Er kann verwendet werden, um Bilder in den Arbeitsspeicher vorzubereiten, bevor das zur tatsächlichen Anzeigeoberfläche des Geräts kompatiblen kopiert.

Wenn ein Speichergerätekontext erstellt wird, wählt GDI automatisch eine monochrome Vorratbitmap für es aus.

Da ein Farbenspeichergerätekontext entweder die Farbe oder monochrome Bitmaps verfügen kann, die ausgewählt werden, ist das Format der Bitmap, die von der CreateCompatibleBitmap-Funktion zurückgegeben wird, nicht immer identisch; ist jedoch das Format einer kompatiblen Bitmaps für einen nonmemory Gerätekontext immer im Format des Geräts.

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

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CBitmap-Klasse

Hierarchiediagramm

CreateCompatibleBitmap

CGdiObject::DeleteObject