Freigeben über


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
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

Weitere Informationen

Bitmapfunktionen

Übersicht über Bitmaps

GetStretchBltMode

SetBrushOrgEx

StretchBlt