Função AngleArc (wingdi.h)

Artigo
08/27/2023

A função AngleArc desenha um segmento de linha e um arco. O segmento de linha é desenhado da posição atual até o início do arco. O arco é desenhado ao longo do perímetro de um círculo com o raio e o centro fornecidos. O comprimento do arco é definido pelos ângulos de início e varredura fornecidos.

Sintaxe

BOOL AngleArc(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] DWORD r,
  [in] FLOAT StartAngle,
  [in] FLOAT SweepAngle
);

Parâmetros

[in] hdc

Identificador para um contexto de dispositivo.

[in] x

Especifica a coordenada x, em unidades lógicas, do centro do círculo.

[in] y

Especifica a coordenada y, em unidades lógicas, do centro do círculo.

[in] r

Especifica o raio, em unidades lógicas, do círculo. Esse valor deve ser positivo.

[in] StartAngle

Especifica o ângulo inicial, em graus, em relação ao eixo x.

[in] SweepAngle

Especifica o ângulo de varredura, em graus, em relação ao ângulo inicial.

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 função AngleArc move a posição atual para o ponto final do arco.

O arco desenhado por essa função pode parecer elíptico, dependendo da transformação atual e do modo de mapeamento. Antes de desenhar o arco, AngleArc desenha o segmento de linha da posição atual até o início do arco.

O arco é desenhado construindo um círculo imaginário ao redor do ponto central especificado com o raio especificado. O ponto de partida do arco é determinado medindo no sentido anti-horário do eixo x do círculo pelo número de graus no ângulo inicial. O ponto final é localizado da mesma forma medindo no sentido anti-horário do ponto de partida pelo número de graus no ângulo de varredura.

Se o ângulo de varredura for maior que 360 graus, o arco será varrido várias vezes.

Essa função desenha linhas usando a caneta atual. A figura não está preenchida.

Exemplos

Para obter um exemplo, consulte Desenho de um gráfico de pizza.

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