Función AngleArc (wingdi.h)

Artículo
03/04/2024

La función AngleArc dibuja un segmento de línea y un arco. El segmento de línea se dibuja desde la posición actual hasta el principio del arco. El arco se dibuja a lo largo del perímetro de un círculo con el radio y el centro especificados. La longitud del arco se define mediante los ángulos inicial y de barrido especificados.

Sintaxis

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 de un contexto de dispositivo.

[in] x

Especifica la coordenada x, en unidades lógicas, del centro del círculo.

[in] y

Especifica la coordenada y, en unidades lógicas, del centro del círculo.

[in] r

Especifica el radio, en unidades lógicas, del círculo. Este valor debe ser positivo.

[in] StartAngle

Especifica el ángulo de inicio, en grados, en relación con el eje X.

[in] SweepAngle

Especifica el ángulo de barrido, en grados, en relación con el ángulo inicial.

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 función AngleArc mueve la posición actual al punto final del arco.

El arco dibujado por esta función puede parecer elíptico, según el modo de transformación y asignación actual. Antes de dibujar el arco, AngleArc dibuja el segmento de línea desde la posición actual hasta el principio del arco.

El arco se dibuja construyendo un círculo imaginario alrededor del punto central especificado con el radio especificado. Para determinar el punto inicial del arco, se mide el número de grados del ángulo inicial en sentido contrario a las agujas del reloj desde el eje x del círculo. El punto final se determina de forma similar; para ello, se mide el número de grados del ángulo de barrido en sentido contrario a las agujas del reloj desde el punto inicial.

Si el ángulo de barrido es mayor que 360 grados, el arco se barrirá varias veces.

Esta función dibuja líneas con el lápiz actual. La figura no se rellena.

Ejemplos

Para obtener un ejemplo, vea Dibujar un gráfico circular.

Requisitos

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