Funzione SetPolyFillMode (wingdi.h)

  • Articolo

La funzione SetPolyFillMode imposta la modalità di riempimento poligono per le funzioni che riempiono i poligoni.

Sintassi

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

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] mode

Nuova modalità di riempimento. Questo parametro può avere uno dei valori seguenti.

Valore Significato
ALTERNATIVO
 Seleziona la modalità alternativa (riempie l'area tra i lati dei poligoni numerati dispari e pari su ogni linea di analisi).
AVVOLGIMENTO
 Seleziona la modalità di avvolgimento (riempie qualsiasi area con un valore di avvolgimento diverso da zero).

Valore restituito

Il valore restituito specifica la modalità di riempimento precedente. Se si verifica un errore, il valore restituito è zero.

Commenti

In generale, le modalità differiscono solo nei casi in cui un poligono complesso e sovrapposto deve essere riempito (ad esempio, un poligono a cinque lati che forma un star a cinque punte con un pentagono al centro). In questi casi, la modalità ALTERNATE riempie tutte le altre aree racchiuse all'interno del poligono (ovvero i punti della star), ma la modalità WINDING riempie tutte le aree (ovvero i punti e il pentagono).

Quando la modalità di riempimento è ALTERNATE, GDI riempie l'area tra i lati poligoni numerati dispari e pari su ogni linea di analisi. Ovvero, GDI riempie l'area tra il primo e il secondo lato, tra il terzo e il quarto lato e così via.

Quando la modalità di riempimento è WINDING, GDI riempie qualsiasi area con un valore di avvolgimento diverso da zero. Questo valore viene definito come il numero di volte in cui una penna usata per disegnare il poligono si sposta nell'area. La direzione di ogni bordo del poligono è importante.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wingdi.h (include Windows.h)
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche

GetPolyFillMode

Funzioni di area

Panoramica delle aree