Funzione Arc (wingdi.h)

Articolo
03/04/2024

La funzione Arc disegna un arco ellittico.

Sintassi

BOOL Arc(
  [in] HDC hdc,
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2,
  [in] int x3,
  [in] int y3,
  [in] int x4,
  [in] int y4
);

Parametri

[in] hdc

Handle al contesto del dispositivo in cui si svolge il disegno.

[in] x1

Coordinata x, in unità logiche, dell'angolo superiore sinistro del rettangolo di selezione.

[in] y1

Coordinata y, in unità logiche, dell'angolo superiore sinistro del rettangolo di selezione.

[in] x2

Coordinata x, in unità logiche, dell'angolo inferiore destro del rettangolo di selezione.

[in] y2

Coordinata y, in unità logiche, dell'angolo inferiore destro del rettangolo di delimitazione.

[in] x3

Coordinata x, in unità logiche, del punto finale della linea radiale che definisce il punto iniziale dell'arco.

[in] y3

Coordinata y, in unità logiche, del punto finale della linea radiale che definisce il punto iniziale dell'arco.

[in] x4

Coordinata x, in unità logiche, del punto finale della linea radiale che definisce il punto finale dell'arco.

[in] y4

Coordinata y, in unità logiche, del punto finale della linea radiale che definisce il punto finale dell'arco.

Valore restituito

Se l'arco viene disegnato, il valore restituito è diverso da zero.

Se l'arco non viene disegnato, il valore restituito è zero.

Commenti

I punti (nLeftRect, nTopRect) e (nRightRect, nBottomRect) specificano il rettangolo di selezione. Un'ellisse formata dal rettangolo di delimitamento specificato definisce la curva dell'arco. L'arco si estende nella direzione di disegno corrente dal punto in cui interseca il radiale dal centro del rettangolo di delimitazione al punto nXStartArc, nYStartArc. L'arco termina dove interseca il radiale dal centro del rettangolo di delimitazione al punto (nXEndArc, nYEndArc). Se il punto iniziale e il punto finale sono uguali, viene disegnato un punto di sospensione completo.

L'arco viene disegnato usando la penna corrente; non è riempito.

La posizione corrente non viene usata né aggiornata da Arc.

Usare le funzioni GetArcDirection e SetArcDirection per ottenere e impostare la direzione di disegno corrente per un contesto del dispositivo. La direzione predefinita del disegno è antiorario.

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