Funzione PolyPolygon (wingdi.h)

Articolo
08/27/2023

La funzione PolyPolygon disegna una serie di poligoni chiusi. Ogni poligono viene delineato usando la penna corrente e riempita usando il pennello corrente e la modalità di riempimento poligono. I poligoni disegnati da questa funzione possono sovrapporsi.

Sintassi

BOOL PolyPolygon(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] const INT   *asz,
  [in] int         csz
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] apt

Puntatore a una matrice di strutture POINT che definiscono i vertici dei poligoni, in coordinate logiche. I poligoni vengono specificati consecutivamente. Ogni poligono viene chiuso automaticamente disegnando una linea dall'ultimo vertice al primo. Ogni vertice deve essere specificato una sola volta.

[in] asz

Puntatore a una matrice di interi, ognuno dei quali specifica il numero di punti nel poligono corrispondente. Ogni intero deve essere maggiore o uguale a 2.

[in] csz

Numero totale di poligoni.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

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

Commenti

La posizione corrente non viene utilizzata né aggiornata da questa funzione.

Tutti i punti aggiuntivi vengono ignorati. Per disegnare i poligoni con più punti, dividere i dati in gruppi, ognuno dei quali ha meno del numero massimo di punti e chiamare la funzione per ogni gruppo di punti. Si noti che è preferibile avere un poligono in uno solo dei gruppi.

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