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

Weitere Informationen

Bitmapfunktionen

Übersicht über Bitmaps

SetStretchBltMode