SetStretchBltMode

Deklaration  

Declare Function SetStretchBltMode Lib "gdi32" ( _
                 ByVal hdc As Long, _
                 ByVal nStretchMode As Long) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel SetStretchBltMode des API-Wikis.

SetStretchBltMode setzt den Vergrößerungsmodus für die Bitmap eines Gerätekontextes. Der Vergrößerungsmodus legt fest, wie Pixel entfernt werden, wenn eine Bitmap verkleinert werden soll. Bitmaps, die vergrößert werden, fügen einfach passende Pixel zwischen die bereits bestehenden ein. Der Vergrößerungsmodus ist eine Eigenschaft des Gerätekontextes und bleibt gültig, bis er Gerätekontext gelöscht oder ein neuer Vergrößerungsmodus gesetzt wird.

Welcher Vergrößerungsmodus der jeweils beste ist, hängt von der zu verkleinernden Bitmap ab. Bilder mit wenigen dünnen Zeilen, werden am effektivsten durch STRETCH_ANDSCANS , Bilder mit wenigen dicken Zeilen am besten mit STRETCH_ORSCANS verarbeitet. Allgemeine Farbbilder verwenden STRETCH_DELETESCANS .

Parameter
hDC	Der gewünschte Gerätekontext.
nStretchMode	Der neue Vergrößerungsmodus. Dabei kann es sich um einen der unten aufgelisteten Werte handeln.

Tabelle 1

Vergrößerungswerte für nStretchMode
STRETCH_ANDSCANS	Führt ein boolisches UND dür die Darbwerte der zu eliminierenden und der existierenden Pixels durch. Wenn es sich um eine Schwarzweiß-Bitmap handelt, werden schwarze Pixel bevorzugt. Dieser Wert ist auch als BLACKONWHITE definiert.
STRETCH_DELETESCANS	Löscht die Pixel. Dieser Modus löscht alle eleminierten Pixelzeilen, ohne zu versuchen, ihre Information beizubehalten. Dieser Wert ist auch als COLORONCOLOR definert.
STRETCH_ORSCANS	Führt ein boolesches ODER für die Farbwerte der zu eliminierenden und der existierenden Pixels durch. Wenn es sich um eine Schwarzweiß-Bitmap handelt, werden die weißen Pixel bevorzugt. Dieser Wert ist auch als WHITEONBLACK definiert.
STRETCH_HALFTONE	Bildet Pixel vom Quell-Rechteck in Blöcken auf das Ziel-Rechteck ab. Die durchschnittliche Farbe im Zielblock stellt annähernd die Farbe der Quellpixel dar. Dieser Wert ist auch als HALFTONE defniert. Nachdem der Vergrößerungsmodus STRETCH_HALFTONE gesetzt wurde, muß eine Anwendung die Funktion SetBrushOrgEx aufrufen, um den Ursprung für den Pinsel zu setzen, andernfalls wird diese fehlerhaft ausgeführt.

Tabelle 2

Rückgabewerte
LONG	Der vorherige Vergrößerungsmodus
0	Es lag ein Fehler vor.

Tabelle 3

Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
GetStretchBltMode, StretchBlt

Zugehörige Tipps

• Bildauschnitt mit API zoomen [Tipp 0069]