Función Arc (wingdi.h)

Artículo
08/27/2023

La función Arc dibuja un arco elíptico.

Sintaxis

BOOL Arc(
  [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

Identificador del contexto del dispositivo en el que tiene lugar el dibujo.

[in] x1

Coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo delimitador.

[in] y1

Coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo delimitador.

[in] x2

Coordenada x, en unidades lógicas, de la esquina inferior derecha del rectángulo delimitador.

[in] y2

Coordenada y, en unidades lógicas, de la esquina inferior derecha del rectángulo delimitador.

[in] x3

Coordenada x, en unidades lógicas, del punto final de la línea radial que define el punto inicial del arco.

[in] y3

Coordenada y, en unidades lógicas, del punto final de la línea radial que define el punto inicial del arco.

[in] x4

Coordenada x, en unidades lógicas, del punto final de la línea radial que define el punto final del arco.

[in] y4

Coordenada y, en unidades lógicas, del punto final de la línea radial que define el punto final del arco.

Valor devuelto

Si se dibuja el arco, el valor devuelto es distinto de cero.

Si el arco no se dibuja, el valor devuelto es cero.

Comentarios

Los puntos (nLeftRect, nTopRect) y (nRightRect, nBottomRect) especifican el rectángulo delimitador. Una elipse formada por el rectángulo delimitador especificado define la curva del arco. El arco se extiende en la dirección de dibujo actual desde el punto donde interseca el radial desde el centro del rectángulo delimitador hasta el punto (nXStartArc, nYStartArc). El arco termina donde interseca el radial desde el centro del rectángulo delimitador hasta el punto (nXEndArc, nYEndArc). Si el punto inicial y el punto final son el mismo, se dibuja una elipse completa.

El arco se dibuja utilizando el lápiz actual; no está rellenado.

Arc no usa ni actualiza la posición actual.

Use las funciones GetArcDirection y SetArcDirection para obtener y establecer la dirección de dibujo actual para un contexto de dispositivo. La dirección de dibujo predeterminada es en sentido contrario a las agujas del reloj.

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