SetPolyFillMode-Funktion (wingdi.h)

Die SetPolyFillMode-Funktion legt den Polygonfüllmodus für Funktionen fest, die Polygone füllen.

Syntax

int SetPolyFillMode(
  [in] HDC hdc,
  [in] int mode
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] mode

Der neue Füllmodus. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
ALTERNATIVE	Wählt alternativen Modus aus (füllt den Bereich zwischen ungeraden und geraden Polygonseiten auf jeder Scanlinie aus).
WICKLUNG	Wählt den Wickelmodus aus (füllt jede Region mit einem nichtzero-Wickelwert aus).

Rückgabewert

Der Rückgabewert gibt den vorherigen Füllmodus an. Wenn ein Fehler auftritt, ist der Rückgabewert 0.

Hinweise

Im Allgemeinen unterscheiden sich die Modi nur in Fällen, in denen ein komplexes, sich überlappende Polygon gefüllt werden muss (z. B. ein fünfseitiges Polygon, das ein fünfzackiges star mit einem Fünfeck in der Mitte bildet). In solchen Fällen füllt der ALTERNATE-Modus jeden anderen eingeschlossenen Bereich innerhalb des Polygons (d. b. die Punkte des star), aber der WINDING-Modus füllt alle Regionen (d. a. die Punkte und das Fünfeck).

Wenn der Füllmodus ALTERNATE ist, füllt GDI den Bereich zwischen ungeraden und geraden Polygonseiten auf jeder Scanzeile aus. Das heißt, GDI füllt den Bereich zwischen der ersten und zweiten Seite, zwischen der dritten und vierten Seite usw.

Wenn der Füllmodus WINDING ist, füllt GDI jede Region aus, die einen Nonzero-Wicklungswert aufweist. Dieser Wert ist definiert, wie oft ein Stift, der zum Zeichnen des Polygons verwendet wird, um die Region herumläuft. Die Richtung der einzelnen Kanten des Polygons ist wichtig.

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

GetPolyFillMode

Regionsfunktionen

Übersicht über Regionen