SetStretchBltMode-Funktion (wingdi.h)
Die SetStretchBltMode-Funktion legt den Bitmapdehnungsmodus im angegebenen Gerätekontext fest.
Syntax
int SetStretchBltMode(
[in] HDC hdc,
[in] int mode
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
[in] mode
Der Dehnungsmodus. Dieser Parameter kann einen der folgenden Werte annehmen.
| Wert | Bedeutung |
|---|---|
|
Führt einen booleschen AND-Vorgang unter Verwendung der Farbwerte für die entfernten und vorhandenen Pixel aus. Wenn es sich bei der Bitmap um eine monochrome Bitmap handelt, behält dieser Modus schwarze Pixel auf Kosten weißer Pixel bei. |
|
Löscht die Pixel. Dieser Modus löscht alle entfernten Pixelzeilen, ohne zu versuchen, ihre Informationen beizubehalten. |
|
Ordnet Pixel aus dem Quellrechteck pixelblöcken im Zielrechteck zu. Die durchschnittliche Farbe über dem Zielblock von Pixeln entspricht der Farbe der Quellpixel.
Nach dem Festlegen des HALFTONE-Dehnungsmodus muss eine Anwendung die SetBrushOrgEx-Funktion aufrufen, um den Pinselursprung festzulegen. Wenn dies nicht der Fall ist, tritt eine Fehlausrichtung des Pinsels auf. |
|
Identisch mit BLACKONWHITE. |
|
Identisch mit COLORONCOLOR. |
|
Identisch mit HALFTONE. |
|
Identisch mit WHITEONBLACK. |
|
Führt einen booleschen OR-Vorgang mit den Farbwerten für die entfernten und vorhandenen Pixel aus. Wenn es sich bei der Bitmap um eine monochrome Bitmap handelt, behält dieser Modus weiße Pixel auf Kosten von schwarzen Pixeln bei. |
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der vorherige Dehnungsmodus.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Diese Funktion kann den folgenden Wert zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Mindestens einer der Eingabeparameter ist ungültig. |
Hinweise
Der Dehnungsmodus definiert, wie das System Zeilen oder Spalten einer Bitmap mit vorhandenen Pixeln auf einem Anzeigegerät kombiniert, wenn eine Anwendung die StretchBlt-Funktion aufruft .
Die Modi BLACKONWHITE (STRETCH_ANDSCANS) und WHITEONBLACK (STRETCH_ORSCANS) werden in der Regel verwendet, um Vordergrundpixel in monochromen Bitmaps beizubehalten. Der COLORONCOLOR-Modus (STRETCH_DELETESCANS) wird in der Regel verwendet, um Farben in Farbbitbitten beizubehalten.
Der HALFTONE-Modus ist langsamer und erfordert mehr Verarbeitung des Quellbilds als die anderen drei Modi. erzeugt jedoch Bilder mit höherer Qualität. Beachten Sie auch, dass SetBrushOrgEx aufgerufen werden muss, nachdem der HALFTONE-Modus festgelegt wurde, um eine falsche Pinselausrichtung zu vermeiden.
Abhängig von den Funktionen des Gerätetreibers sind möglicherweise auch zusätzliche Stretchmodi verfügbar.
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 (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |