Função ArcTo (wingdi.h)

A função ArcTo desenha um arco elíptico.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo em que o desenho ocorre.

[in] left

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

[in] top

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

[in] right

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

[in] bottom

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

[in] xr1

A coordenada x, em unidades lógicas, do ponto de extremidade do radial que define o ponto de partida do arco.

[in] yr1

A coordenada y, em unidades lógicas, do ponto de extremidade do radial que define o ponto de partida do arco.

[in] xr2

A coordenada x, em unidades lógicas, do ponto de extremidade do radial que define o ponto final do arco.

[in] yr2

A coordenada y, em unidades lógicas, do ponto de extremidade do radial que define o ponto final do arco.

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

ArcTo é semelhante à função Arc , exceto que a posição atual é atualizada.

Os pontos (nLeftRect, nTopRect) e (nRightRect, nBottomRect) especificam o retângulo delimitador. Uma elipse formada pelo retângulo delimitador especificado define a curva do arco. O arco estende o sentido anti-horário do ponto em que cruza a linha radial do centro do retângulo delimitador para o ponto (nXRadial1, nYRadial1). O arco termina onde cruza a linha radial do centro do retângulo delimitador para o ponto (nXRadial2, nYRadial2). Se o ponto de partida e o ponto final forem os mesmos, uma elipse completa será desenhada.

Uma linha é desenhada da posição atual para o ponto inicial do arco. Se nenhum erro ocorrer, a posição atual será definida como o ponto final do arco.

O arco é desenhado usando a caneta atual; ele não está preenchido.

Requisitos

Requisito	Valor
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

Confira também

AngleArc

Arc

Funções de linha e curva

Visão geral de linhas e curvas

SetArcDirection