Die Community zu .NET und Classic VB.
Menü

StretchBlt

 von 

Deklaration  

Declare Function StretchBlt Lib "gdi32" ( _
                 ByVal hdc As Long, _
                 ByVal x As Long, _
                 ByVal y As Long, _
                 ByVal nWidth As Long, _
                 ByVal nHeight As Long, _
                 ByVal hSrcDC As Long, _
                 ByVal xSrc As Long, _
                 ByVal ySrc As Long, _
                 ByVal nSrcWidth As Long, _
                 ByVal nSrcHeight As Long, _
                 ByVal dwRop As Long) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel StretchBlt des API-Wikis.

StretchBlt kopiert eine Bitmap aus einem quellrechteck in ein Zielrechteck, wobei gegebenenfalls eine Vergrößerung oder Verkleinerung gemäß dem aktuellen Vergrößerungsmodus durchgeführt wird. Das Bild kann unter Verwendung entgegengesetzter Vorzeichen für Breiten- und Höhenparameter von Quelle und Ziel invertiert oder umgedreht werden.

Diese Funktion ist gut geeignet für Fenster deren Größe verändert werden kann, aber möglicherweise ist es auch notwendig eine Bitmap zu verändern, abhängig von der Fenstergröße. Starke Vergrößerungen von Bitmaps resultieren in ausgefransten Kanten. Für größere Bilder sollten Sie Metadateien in Betracht ziehen.

Parameter
hDCDer Ziel-Gerätekontext.
xDie x-Koordinate der linken oberen Ecke des Zielrechtecks, angegeben in logischen Einheiten.
yDie y-Koordinate der linken oberen Ecke des Zielrechtecks, angegeben in logischen Einheiten.
nWidthDie Breite des Zielrechtecks, angegeben in logischen Einheiten.
nHeightDie Höhe des Zielrechtecks, angegeben in logischen Einheiten.
xSrcDie x-Koordinate der linken oberen Ecke des Quell-Rechtecks, angegeben in logischen Einheiten.
ySrcDie x-Koordinate der linken oberen Ecke des Quell-Rechtecks, angegeben in logischen Einheiten.
nSrcWidthDie Breite des Quellrechtecks, angegeben in logischen Einheiten.
nSrcHeightDie Höhe des Quellrechtecks, angegeben in logischen Einheiten.
dwRopDer Raster-Operationscode. 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
SetStretchBltMode, GetDeviceCaps, BitBlt

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel