CreateCompatibleBitmap-Funktion (wingdi.h)

Artikel
03/13/2024

Die Funktion CreateCompatibleBitmap erstellt eine Bitmap, die mit dem Gerät kompatibel ist, das dem angegebenen Gerätekontext zugeordnet ist.

Syntax

HBITMAP CreateCompatibleBitmap(
  [in] HDC hdc,
  [in] int cx,
  [in] int cy
);

Parameter

[in] hdc

Ein Handle für einen Gerätekontext.

[in] cx

Die Bitmapbreite in Pixel.

[in] cy

Die Bitmaphöhe in Pixel.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die kompatible Bitmap (DDB).

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

Das Farbformat der Bitmap, die von der CreateCompatibleBitmap-Funktion erstellt wurde, entspricht dem Farbformat des Geräts, das durch den hdc-Parameter identifiziert wird. Diese Bitmap kann in jedem Speichergerätekontext ausgewählt werden, der mit dem ursprünglichen Gerät kompatibel ist.

Da Speichergerätekontexte sowohl Farb- als auch monochrome Bitmaps zulassen, unterscheidet sich das Format der Bitmap, die von der CreateCompatibleBitmap-Funktion zurückgegeben wird, wenn der angegebene Gerätekontext ein Arbeitsspeichergerätekontext ist. Eine kompatible Bitmap, die für einen nicht-memory-Gerätekontext erstellt wurde, besitzt jedoch immer das gleiche Farbformat und verwendet dieselbe Farbpalette wie der angegebene Gerätekontext.

Hinweis: Wenn ein Speichergerätekontext erstellt wird, ist zunächst eine 1-mal-1-monochrome Bitmap darin ausgewählt. Wenn dieser Speichergerätekontext in CreateCompatibleBitmap verwendet wird, ist die bitmap, die erstellt wird, eine monochrome Bitmap. Verwenden Sie zum Erstellen einer Farbbitte die HDC , die zum Erstellen des Kontexts des Speichergeräts verwendet wurde, wie im folgenden Code gezeigt:


    HDC memDC = CreateCompatibleDC ( hDC );
    HBITMAP memBM = CreateCompatibleBitmap ( hDC, nWidth, nHeight );
    SelectObject ( memDC, memBM );

Wenn eine Anwendung die Parameter nWidth oder nHeight auf Null festlegt, gibt CreateCompatibleBitmap das Handle auf eine monochrome Bitmap mit 1 x 1 Pixel zurück.

Wenn ein DIB-Abschnitt, bei dem es sich um eine Bitmap handelt, die von der CreateDIBSection-Funktion erstellt wurde, in dem durch den hdc-Parameter identifizierten Gerätekontext ausgewählt wird, erstellt CreateCompatibleBitmap einen DIB-Abschnitt.

Wenn Sie die Bitmap nicht mehr benötigen, rufen Sie die DeleteObject-Funktion auf, um sie zu löschen.

Beispiele

Ein Beispiel finden Sie unter Skalieren eines Images.

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	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll