Funzione CreatePolyPolygonRgn (wingdi.h)

Articolo
03/04/2024

La funzione CreatePolyPolygonRgn crea un'area costituita da una serie di poligoni. I poligoni possono sovrapporsi.

Sintassi

HRGN CreatePolyPolygonRgn(
  [in] const POINT *pptl,
  [in] const INT   *pc,
  [in] int         cPoly,
  [in] int         iMode
);

Parametri

[in] pptl

Puntatore a una matrice di strutture POINT che definiscono i vertici dei poligoni in unità logiche. I poligoni vengono specificati consecutivamente. Ogni poligono viene presunto chiuso e ogni vertice viene specificato una sola volta.

[in] pc

Puntatore a una matrice di interi, ognuno dei quali specifica il numero di punti in uno dei poligoni nella matrice a cui punta lppt.

[in] cPoly

Numero totale di interi nella matrice a cui punta lpPolyCounts.

[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 è zero.

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.

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