Funzione AngleArc (wingdi.h)

Articolo
03/04/2024

La funzione AngleArc disegna un segmento di linea e un arco. Il segmento di linea viene disegnato dalla posizione corrente all'inizio dell'arco. L'arco viene disegnato lungo il perimetro di un cerchio con il raggio e il centro specificati. La lunghezza dell'arco è definita dall'angolo iniziale e spazza specificato.

Sintassi

BOOL AngleArc(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] DWORD r,
  [in] FLOAT StartAngle,
  [in] FLOAT SweepAngle
);

Parametri

[in] hdc

Handle per un contesto di dispositivo.

[in] x

Specifica la coordinata x, in unità logiche, del centro del cerchio.

[in] y

Specifica la coordinata y, in unità logiche, del centro del cerchio.

[in] r

Specifica il raggio, nelle unità logiche, del cerchio. Il valore deve essere positivo.

[in] StartAngle

Specifica l'angolo di inizio, in gradi, rispetto all'asse x.

[in] SweepAngle

Specifica l'angolo di sweep, in gradi, rispetto all'angolo iniziale.

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 AngleArc sposta la posizione corrente al punto finale dell'arco.

L'arco disegnato da questa funzione può sembrare ellittico, a seconda della trasformazione corrente e della modalità di mapping. Prima di disegnare l'arco, AngleArc disegna il segmento di linea dalla posizione corrente all'inizio dell'arco.

L'arco viene disegnato creando un cerchio immaginario intorno al punto centrale specificato con il raggio specificato. Il punto iniziale dell'arco è determinato misurando antiorario dall'asse x del cerchio in base al numero di gradi nell'angolo iniziale. Il punto finale si trova analogamente misurando antiorario dal punto iniziale in base al numero di gradi nell'angolo di sweep.

Se l'angolo di scorrimento è maggiore di 360 gradi, l'arco viene spazzato più volte.

Questa funzione disegna linee usando la penna corrente. La figura non è compilata.

Esempio

Per un esempio, vedere Disegno di un grafico a torta.

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