Freigeben über


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