Funzione CreatePolygonRgn (wingdi.h)

Articolo
03/08/2023

La funzione CreatePolygonRgn crea un'area poligonale.

Sintassi

HRGN CreatePolygonRgn(
  [in] const POINT *pptl,
  [in] int         cPoint,
  [in] int         iMode
);

Parametri

[in] pptl

Puntatore a una matrice di strutture POINT che definiscono i vertici del poligono in unità logiche. Il poligono è presunto chiuso. Ogni vertice può essere specificato una sola volta.

[in] cPoint

Numero di punti nella matrice.

[in] iMode

Modalità di riempimento usata per determinare quali pixel si trovano nell'area. 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).

Per altre informazioni su queste modalità, vedere la funzione SetPolyFillMode .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'handle per l'area.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Quando l'oggetto HRGN non è più necessario, chiamare la funzione DeleteObject per eliminarla.

Le coordinate dell'area sono rappresentate come interi con segno a 27 bit.

Le aree create dai metodi Create<shape>Rgn (ad esempio CreateRectRgn e CreatePolygonRgn) includono solo l'interno della forma. Il contorno della forma viene escluso dall'area. Ciò significa che qualsiasi punto su una linea tra due vertici sequenziali non è incluso nell'area. Se si dovesse chiamare PtInRegion per un punto di questo tipo, verrà restituito zero come risultato.

Requisiti


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