Función acorde (wingdi.h)

Artículo
03/08/2023

La función Acorde dibuja un acorde (una región limitada por la intersección de una elipse y un segmento de línea, denominado secant). El acorde se describe mediante el lápiz actual y se rellena mediante el pincel actual.

Sintaxis

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
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo en el que aparece el acorde.

[in] x1

Coordenada x, en coordenadas lógicas, de la esquina superior izquierda del rectángulo delimitador.

[in] y1

Coordenada y, en coordenadas lógicas, de la esquina superior izquierda del rectángulo delimitador.

[in] x2

Coordenada x, en coordenadas lógicas, de la esquina inferior derecha del rectángulo delimitador.

[in] y2

Coordenada y, en coordenadas lógicas, de la esquina inferior derecha del rectángulo delimitador.

[in] x3

Coordenada x, en coordenadas lógicas, del extremo del radial que define el principio del acorde.

[in] y3

Coordenada y, en coordenadas lógicas, del extremo del radial que define el principio del acorde.

[in] x4

Coordenada x, en coordenadas lógicas, del extremo del radial que define el final del acorde.

[in] y4

Coordenada y, en coordenadas lógicas, del extremo del radial que define el final del acorde.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

La curva del acorde se define mediante una elipse que se ajusta al rectángulo delimitador especificado. La curva comienza en el punto en el que la elipse interseca el primer radial y se extiende en sentido contrario a las agujas del reloj hasta el punto donde la elipse interseca el segundo radial. El acorde está cerrado dibujando una línea desde la intersección del primer radial y la curva hasta la intersección del segundo radial y la curva.

Si el punto inicial y el punto final de la curva son los mismos, se dibuja una elipse completa.

La posición actual no se usa ni se actualiza por Chord.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll