CDC::StretchBlt
Kopiert eine Bitmap aus einem Quellrechteck in ein Zielrechteck und bei Bedarf oder komprimiert wird die Bitmap, um die Dimensionen des Zielrechtecks angepasst.
BOOL StretchBlt(
int x,
int y,
int nWidth,
int nHeight,
CDC* pSrcDC,
int xSrc,
int ySrc,
int nSrcWidth,
int nSrcHeight,
DWORD dwRop
);
Parameter
x
Gibt die X-Koordinate (in logischen Einheiten) der linken oberen Ecke des Zielrechtecks an.y
Gibt die y-Koordinate (in logischen Einheiten) der linken oberen Ecke des Zielrechtecks an.nWidth
Gibt die Breite (in logischen Einheiten) des Zielrechtecks an.nHeight
Gibt die Höhe (in logischen Einheiten) des Zielrechtecks an.pSrcDC
Gibt den Quellgerätekontext an.xSrc
Gibt die X-Koordinate (in logischen Einheiten) der linken oberen Ecke des Quellrechtecks an.ySrc
Gibt die X-Koordinate (in logischen Einheiten) der linken oberen Ecke des Quellrechtecks an.nSrcWidth
Gibt die Breite (in logischen Einheiten) des Quellrechtecks an.nSrcHeight
Gibt die Höhe (in logischen Einheiten) des Quellrechtecks an.dwRop
Gibt den ausgeführt werden, anvorgang Raster.RasterOperationscodes definieren, wie GDI Farben in den Ausgabevorgängen kombiniert, die einen aktuellen Pinsel, eine mögliche Quellbitmap und eine Zielbitmap einschließen.Dieser Parameter kann einer der folgenden Werte:BLACKNESS dreht alle Ausgabeschwarz.
DSTINVERT gibt die Zielbitmap um.
MERGECOPY kombiniert das Muster und die Quellbitmap mithilfe des booleschen AND-Operators.
MERGEPAINT kombiniert die umgekehrte Quellbitmap mit der Zielbitmap mithilfe des booleschen OR-Operators.
NOTSRCCOPY kopiert die umgekehrte Quellbitmap zum Ziel.
NOTSRCERASE gibt das Ergebnis der Kombination des Ziels und der Quellbitmaps mithilfe des booleschen OR-Operators um.
PATCOPY kopiert das Muster zur Zielbitmap.
PATINVERT kombiniert die Zielbitmap mit dem Muster mithilfe des Operators eines booleschen Werts XOR.
PATPAINT kombiniert die umgekehrte Quellbitmap mit dem Muster mithilfe des booleschen OR-Operators.Kombiniert das Ergebnis dieses Vorgangs mit der Zielbitmap mithilfe des booleschen OR-Operators.
SRCAND kombiniert Pixel des Ziels und der Quellbitmaps mithilfe des booleschen AND-Operators.
SRCCOPY kopiert die Quellbitmap zur Zielbitmap.
SRCERASE gibt die Zielbitmap um kombiniert und das Ergebnis mit der Quellbitmap mithilfe des booleschen AND-Operators.
SRCINVERT kombiniert Pixel des Ziels und der Quellbitmaps mithilfe des Operators eines booleschen Werts XOR.
SRCPAINT kombiniert Pixel des Ziels und der Quellbitmaps mithilfe des booleschen OR-Operators.
WHITENESS dreht alle Ausgabe weiß.
Rückgabewert
ungleich 0 (null), wenn die Bitmap gezeichnet wird; andernfalls 0.
Hinweise
Die Funktion verwendet den Streckmodus des Zielgerätekontexts (festgelegt durch SetStretchBltMode) um festzustellen wie die Bitmap wird oder komprimiert.
Die Funktion StretchBlt verschiebt die Bitmap vom Quellgerät, das von pSrcDC für das Zielgerät angegeben ist, das durch das Gerätekontextobjekt dargestellt wird, dessen - Memberfunktion aufgerufen wird.xSrc, ySrc, nSrcWidth und nSrcHeight-Parameter definieren die obere linke Ecke und die Abmessungen des Quellrechtecks.Das x, y, nWidth und nHeight-Parameter die obere linke Ecke und die Abmessungen des Zielrechtecks.Der Rastervorgang, der von dwRop angegeben wird, definiert, wie die Quellbitmap und die Bits bereits auf dem Zielgerät kombiniert werden.
Die StretchBlt-Funktion erstellt ein Spiegelbild einer Bitmap, wenn die Zeichen nSrcWidth und des nWidth oder des nSrcHeight und der nHeight-Parameter unterscheiden.Wenn nSrcWidth und nWidth verschiedene Zeichen haben, erstellt die Funktion ein Spiegelbild der Bitmap entlang der x-Achse.Wenn nSrcHeight und nHeight verschiedene Zeichen haben, erstellt die Funktion ein Spiegelbild der Bitmap entlang der y-Achse.
Die Funktion wird StretchBlt oder komprimiert die Quellbitmap im Arbeitsspeicher und kopiert dann das Ergebnis dem Ziel.Wenn ein Muster dem Ergebnis zusammengeführt werden soll, wird es nicht zusammengeführt, bis die gestreckte Quellbitmap in das Ziel kopiert wurde.Wenn ein Pinsel verwendet wird, ist der ausgewählte Pinseln im Zielgerätekontext.Die Zielkoordinaten werden nach dem Zielgerätekontext transformiert; die Quellkoordinaten werden nach dem Quellgerätekontext transformiert.
Wenn das Ziel, Quelle und die Musterbitmaps nicht das gleiche Farbenformat haben, konvertiert StretchBlt die Quell- und Musterbitmaps, um die Zielbitmaps übereinstimmt.Der Vordergrund- und Hintergrundfarben des Zielgerätekontexts werden in der Konvertierung verwendet.
Wenn StretchBlt eine monochrome Bitmap konvertieren muss, um zu Farbe, setzt sie weiße Bits (1) dem Hintergrundfarben- und Schwarzbits (0) an die Vordergrundfarbe fest.Um Farbe auf Monochrom zu konvertieren, wird die Pixel die Hintergrundfarbe an Weiß (1) anpassen fest und legt alle anderen Pixel fest um auf Schwarz (0).Der Vordergrund- und Hintergrundfarben des Gerätekontexts mit Farbe verwendet werden.
Nicht alle Geräte unterstützen die StretchBlt-Funktion.Um nach gewünschtem ein Gerät StretchBlt unterstützt, rufen Sie die GetDeviceCaps-Memberfunktion mit dem RASTERCAPS Index auf und überprüfen Sie den Rückgabewert für das RC_STRETCHBLT-Flag.
Anforderungen
Header: afxwin.h