Função Chord (wingdi.h)

Artigo
08/27/2023

A função Acorde desenha um acorde (uma região delimitada pela interseção de uma elipse e um segmento de linha, chamado de secante). O acorde é descrito usando a caneta atual e preenchido usando o pincel atual.

Sintaxe

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

Um identificador para o contexto do dispositivo no qual o acorde é exibido.

[in] x1

A coordenada x, em coordenadas lógicas, do canto superior esquerdo do retângulo delimitador.

[in] y1

A coordenada y, em coordenadas lógicas, do canto superior esquerdo do retângulo delimitador.

[in] x2

A coordenada x, em coordenadas lógicas, do canto inferior direito do retângulo delimitador.

[in] y2

A coordenada y, em coordenadas lógicas, do canto inferior direito do retângulo delimitador.

[in] x3

A coordenada x, em coordenadas lógicas, do ponto de extremidade do radial que define o início da corda.

[in] y3

A coordenada y, em coordenadas lógicas, do ponto de extremidade do radial que define o início da corda.

[in] x4

A coordenada x, em coordenadas lógicas, do ponto de extremidade do radial que define o final da corda.

[in] y4

A coordenada y, em coordenadas lógicas, do ponto de extremidade do radial que define o final da corda.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

A curva do acorde é definida por uma elipse que se ajusta ao retângulo delimitador especificado. A curva começa no ponto em que a elipse cruza o primeiro radial e se estende no sentido anti-horário até o ponto em que a elipse cruza o segundo radial. O acorde é fechado desenhando uma linha da interseção do primeiro radial e da curva até a interseção do segundo radial e da curva.

Se o ponto inicial e o ponto final da curva forem iguais, uma elipse completa será desenhada.

A posição atual não é usada nem atualizada por Chord.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll