CDC::BitBlt 

BOOL BitBlt( int x, int y, int nWidth, int nHeight, CDC* pSrcDC, int xSrc, int ySrc, DWORD dwRop );

Rückgabewert

Ungleich NULL, wenn die Funktion erfolgreich ist; andernfalls 0.

Parameter

x

Gibt die logische X-Koordinate der linken oberen Ecke des Zielrechtecks.

y

Gibt die logische y-Koordinate der linken oberen Ecke des Zielrechtecks.

nWidth

Gibt die Breite (in logischen Einheiten) der Ziel-Bitmap Rechteck und Quellcode.

nHeight

Gibt die Höhe (in logischen Einheiten) der Ziel-Bitmap Rechteck und Quellcode.

pSrcDC

Zeiger auf ein CDC -Objekt, das den Gerätekontext identifiziert, von dem die Bitmap kopiert werden. Es muss NULL sein, wenn DwRop einen Raster-Vorgang angibt, der keine Quelle enthält.

xSrc

Gibt die logische X-Koordinate der oberen linken Ecke des Quell-bitmap.

ySrc

Gibt die logische y-Koordinate der oberen linken Ecke des Quell-bitmap.

dwRop

Gibt die RasterOperation durchgeführt werden. Raster-Operation Codes definieren, wie das GDI kombiniert Farben in Output-Operationen, bei denen eine aktuelle Pinsel, eine mögliche Quellbitmap und eine Ziel-Bitmap. Die folgenden Listen RasterOperation Codes für DwRop und ihre Beschreibungen:

Eine vollständige Liste der RasterOperation Codes finden Sie unter über Raster Operation Codes im Abschnitt Anlagen der Win32 SDK Programmer's Reference.

Bemerkungen

Kopiert eine Bitmap aus dem Quellcode-Gerätekontext für diese aktuellen Gerätekontext.

Die Anwendung kann die Windows oder Client-Bereiche auf Byte-Grenzen um sicherzustellen, dass die BitBlt -Operationen auf Byte ausgerichteten Rechtecke auftreten ausrichten. (Festlegen Sie die CS_BYTEALIGNWINDOW oder CS_BYTEALIGNCLIENT -Flags, wenn Sie die Fensterklassen registrieren.)

BitBlt -Operationen mit Byte ausgerichteten Rechtecke sind deutlich schneller als BitBlt -Operationen auf Rechtecke, die nicht Byte ausgerichtet sind. Wenn Sie Klasse Formatvorlagen wie z. B. Byte-Ausrichtung für eigene Gerätekontext angeben möchten, müssen Sie eine Fensterklasse registrieren anstatt auf der Microsoft Foundation Classes für Sie tun. Verwenden Sie die globale Funktion ist.

GDI transformiert nWidth und nHeight, einmal mit den Zielgerätekontext und einmal mit den Quellcode-Gerätekontext. Wenn die resultierenden Blöcke nicht übereinstimmen, verwendet GDI die Windows StretchBlt Funktion zum Komprimieren oder ausdehnen der Quell-Bitmap nach Bedarf.

Wenn Ziel, Quelle und Muster Bitmaps nicht das gleiche Farbformat haben, konvertiert die BitBlt -Funktion die Source und Pattern Bitmaps mit das Ziel übereinstimmen. Die Vorder- und Hintergrundfarben Farben der Ziel-Bitmap sind in der Konvertierung verwendet.

Wenn die BitBlt -Funktion eine monochrome Bitmap in Farbe konvertiert, wird weiß Bits (1) auf die Hintergrundfarbe und schwarz (0) auf die Vordergrundfarbe. Die Vorder- und Hintergrundfarben Farben des Zielgerätekontexts dienen. Um Farbe in Schwarzweiß konvertieren, BitBlt legt Pixel, die die Hintergrundfarbe auf weiß entsprechen und alle anderen Pixel auf schwarz. BitBlt verwendet die Vordergrund- und Hintergrundfarben Farben des Gerätekontexts Farbe von Farbe in Schwarzweiß konvertieren.

Beachten Sie, dass nicht alle Gerätekontexte BitBltunterstützen. Um zu überprüfen, ob ein gegebenen Gerätekontext BitBltunterstützt, verwenden Sie die Member-Funktion GetDeviceCaps und geben Sie den RASTERCAPS -index.

Übersicht über die CDCMember der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CDC::GetDeviceCaps, CDC::PatBlt, CDC::SetTextColor, CDC::StretchBlt, :: StretchDIBits, :: BitBlt

Index