Função Chord (wingdi.h)
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 |