Funzione chord (wingdi.h)

Articolo
03/08/2023

La funzione Chord disegna un accordo (un'area delimitata dall'intersezione di un puntoni di sospensione e un segmento di linea, denominato secante). Il coro è descritto usando la penna corrente e riempita usando il pennello corrente.

Sintassi

BOOL Chord(
  [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 viene visualizzato il coro.

[in] x1

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

[in] y1

Coordinata y, in coordinate logiche, dell'angolo superiore sinistro del rettangolo di delimitazione.

[in] x2

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

[in] y2

Coordinata y, in coordinate logiche, dell'angolo inferiore destro del rettangolo di selezione.

[in] x3

Coordinata x, in coordinate logiche, dell'endpoint del radiale che definisce l'inizio della corda.

[in] y3

Coordinata y, in coordinate logiche, dell'endpoint del radiale che definisce l'inizio del accordo.

[in] x4

Coordinata x, in coordinate logiche, dell'endpoint del radiale che definisce la fine della corda.

[in] y4

Coordinata y, in coordinate logiche, dell'endpoint del radiale che definisce la fine del accordo.

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 curva del coro è definita da un'ellisse che si adatta al rettangolo di delimitamento specificato. La curva inizia al punto in cui i puntini di sospensione interseca il primo radiale e si estende in senso antiorario al punto in cui l'ellisse interseca il secondo radiale. Il coro è chiuso disegnando una linea dall'intersezione del primo radiale e dalla curva all'intersezione del secondo radiale e della curva.

Se il punto iniziale e il punto finale della curva sono uguali, viene disegnato un punto di sospensione completo.

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

Requisiti


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