GetStretchBltMode-Funktion (wingdi.h)
Die GetStretchBltMode-Funktion ruft den aktuellen Stretchmodus ab. Der Dehnungsmodus definiert, wie Farbdaten zu Bitmaps hinzugefügt oder daraus entfernt werden, die beim Aufrufen der StretchBlt-Funktion gestreckt oder komprimiert werden.
Syntax
int GetStretchBltMode(
[in] HDC hdc
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der aktuelle Dehnungsmodus. Dies kann einer der folgenden Werte sein.
| Wert | BESCHREIBUNG |
|---|---|
| BLACKONWHITE | 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, bleiben in diesem Modus schwarze Pixel auf Kosten weißer Pixel erhalten. |
| COLORONCOLOR | Löscht die Pixel. Dieser Modus löscht alle entfernten Zeilen von Pixeln, ohne ihre Informationen beizubehalten. |
| HALBTON | Ordnet Pixel aus dem Quellrechteck in Pixelblöcken im Zielrechteck zu. Die durchschnittliche Farbe über dem Zielblock von Pixeln entspricht der Farbe der Quellpixel. |
| STRETCH_ANDSCANS | Identisch mit BLACKONWHITE. |
| STRETCH_DELETESCANS | Identisch mit COLORONCOLOR. |
| STRETCH_HALFTONE | Identisch mit HALFTONE. |
| STRETCH_ORSCANS | Identisch mit WHITEONBLACK. |
| WHITEONBLACK | Führt einen booleschen OR-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 weiße Pixel auf Kosten schwarzer Pixel bei. |
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
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 (einschließlich Windows.h) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |