Funzione ArcTo (wingdi.h)

Articolo
03/04/2024

La funzione ArcTo disegna un arco ellittico.

Sintassi

BOOL ArcTo(
  [in] HDC hdc,
  [in] int left,
  [in] int top,
  [in] int right,
  [in] int bottom,
  [in] int xr1,
  [in] int yr1,
  [in] int xr2,
  [in] int yr2
);

Parametri

[in] hdc

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

[in] left

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

[in] top

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

[in] right

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

[in] bottom

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

[in] xr1

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

[in] yr1

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

[in] xr2

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

[in] yr2

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

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

ArcTo è simile alla funzione Arc , ad eccezione del fatto che la posizione corrente viene aggiornata.

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 estende in senso antiorario dal punto in cui interseca la linea radiale dal centro del rettangolo di selezione al punto (nXRadial1, nYRadial1). L'arco termina dove interseca la linea radiale dal centro del rettangolo di delimitazione al punto (nXRadial2, nYRadial2). Se il punto iniziale e il punto finale sono uguali, viene disegnato un punto di sospensione completo.

Una linea viene disegnata dalla posizione corrente al punto iniziale dell'arco. Se non si verifica alcun errore, la posizione corrente viene impostata sul punto finale dell'arco.

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

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