SetStretchBltMode-Funktion (wingdi.h)

Artikel
03/13/2024

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
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, behält dieser Modus schwarze Pixel auf Kosten weißer Pixel bei.
COLORONCOLOR	Löscht die Pixel. Dieser Modus löscht alle entfernten Pixelzeilen, ohne zu versuchen, ihre Informationen beizubehalten.
HALBTON	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.
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 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
ERROR_INVALID_PARAMETER	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