Funzione CloseFigure (wingdi.h)

Articolo
03/13/2024

La funzione CloseFigure chiude una figura aperta in un percorso.

Sintassi

BOOL CloseFigure(
  [in] HDC hdc
);

Parametri

[in] hdc

Gestire il contesto del dispositivo in cui verrà chiusa la figura.

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 funzione CloseFigure chiude la figura disegnando una linea dalla posizione corrente al primo punto della figura (in genere, il punto specificato dalla chiamata più recente alla funzione MoveToEx ) e quindi connette le righe usando lo stile di join della riga. Se una figura viene chiusa usando la funzione LineTo anziché CloseFigure, vengono usati i limiti finali per creare l'angolo anziché un join.

La funzione CloseFigure deve essere chiamata solo se è presente una parentesi del percorso aperto nel contesto del dispositivo specificato.

Una figura in un percorso è aperta a meno che non sia chiusa in modo esplicito usando questa funzione. Una figura può essere aperta anche se il punto corrente e il punto iniziale della figura sono uguali.

Dopo una chiamata a CloseFigure, aggiungere una linea o una curva al percorso inizia una nuova figura.

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