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