Die Community zu .NET und Classic VB.
Menü

BitBlt

 von 

Deklaration  

Declare Function BitBlt Lib "gdi32" ( _
                 ByVal hDCDest As Long, _
                 ByVal XDest As Long, _
                 ByVal YDest As Long, _
                 ByVal nWidth As Long, _
                 ByVal nHeight As Long, _
                 ByVal hDCSrc As Long, _
                 ByVal XSrc As Long, _
                 ByVal YSrc As Long, _
                 ByVal dwRop As Long) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel BitBlt des API-Wikis.

BitBlt ist die Standardfunktion für die Anzeige von Bitmaps. Sie kopiert eine Bitmap aus einem Speicher-Gerätekontext in einen anderen Gerätekontext, etwa in den eines Fensters. Die Bitmap muß zunächst in einem Speicher-Gerätekontext selektiert werden, der mit CreateCompatibleDC erzeugt wird.

Die Bitmap kann unter Verwendung der Rasteroperationen mit dem existierenden Hintergrund kombiniert werden. Nicht alle Geräte unterstützen BitBlt. Anhand des RASTERCAPS-Rückgabewerts aus der Funktion GetDeviceCaps können Sie feststellen, ob BitBlt-Operationen unterstützt werden.

Parameter
hDCDestHDC: Der Gerätekontext-Handle für die Bitmap
XDestDie logische x-Koordinate der oberen linken Ecke des Ziel-Rechtecks
YDestDie logische y-Koordinate der oberen linken Ecke des Ziel-Rechtecks
nWidthDie Breite des Quell- und Zielrechtecks, angegeben in logischen Einheiten
nHeightDie Höhe des Quell- und Zielrechtecks, angegeben in logischen Einheiten
hDCSrcDerGerätekontext aus dem die Bitmap kopiert wird. Dabei handelt es sich normalerweise um ein Speicher-Gerätekontext, der mit CreateCompatibleDC erzeugt wurde.
XSrcDie logische x-Koordinate der oberen linken Ecke des Quell-Rechtecks
YSrcDie logische y-Koordinate der oberen linken Ecke des Quell-Rechtecks
dwRopDer Raster-Operationscode. Diese Codes definieren, wie die Farbdaten des Quell-Rechtecks kombiniert werden, um die endgültige Farbe zu erhalten. Untenstehende Tabelle zeigt einige der gebräuchlisten Raster-Operationscodes

Tabelle 1


Gängige Rasteroperationscodes [ROPs] für dwRop
BLACKNESSSetzt alle Ausgaben auf die Farb, die in der physikalischen Palette den Index 0 hat (für die Standardpalette ist das schwarz)
DSTINVERTInvertiert das Zielrechteck
MERGECOPYDie Quell- und Ziel-Bitmaps werden durch das Boolesche UND verknüpft.
MERGEPAINTDie Quell- und Ziel-Bitmaps werden durch das Boolesche ODER verknüpft.
NOTSRCCOPYInvertiert die Quellbitmap und kopiert sie dann aufs Ziel
NOTSRCERASEInvertiert das Ergebnis der Kombination von Quell- und Zielbitmap unter Verwendung der booleschen ODER.
PATCOPYKopiert ein Muster aufs Ziel
PATINVERTKombiniert die Ziel-Bitmap unter Verwendung des booleschen XODER mit dem Muster
PATPAINTKombiniert die Farben des Musters mit den Farben des invertierten des invertierten Quellrechtecks, wozu der boolesche ODER-Operator verwendet wird. Das ERgebnis wird mit den Farben der Zielbitmap kombiniert, ebenfalss durch das boolesche ODER
SRCANDKombiniert die Quell- und Zielbitmaps mit dem booleschen UND
SRCCOPYKopiert die Quelle direkt auf das Ziel
SRCERASEKombiniert die invertierten Farben der Ziel-Bitmap mit den Farben der Quell-Bitmap, wozu das boolesche UND verwendet wird
SRCINVERTKombiniert die Quell- und Zielbitmaps mit dem booleschen XODER
SRCPAINTKombiniert die Quell- und Zielbitmaps mit dem booleschen ODER
SRCWHITENESSSetzt die Ausgabe auf die Farbe, der in der physikalischen Palette der Index 1 zugeordnet ist (für die Standardpalette ist dies Weiß)

Tabelle 2


Rückgabewerte
TRUEFalls die Funktion erfolgreich ausgeführt werden konnte
FALSEEs gab Fehler und die Funktion wurde nicht ausgeführt

Tabelle 3


Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
CreateCompatibleDC, DeleteObject, LoadBitmap, SelectObject, GetDeviceCaps

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel