Função Arc (wingdi.h)

Artigo
03/04/2024

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

Sintaxe

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

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

[in] x1

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

[in] y1

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

[in] x2

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

[in] y2

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

[in] x3

A coordenada x, em unidades lógicas, do ponto final da linha radial que define o ponto inicial do arco.

[in] y3

A coordenada y, em unidades lógicas, do ponto final da linha radial que define o ponto inicial do arco.

[in] x4

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

[in] y4

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

Retornar valor

Se o arco for desenhado, o valor retornado será diferente de zero.

Se o arco não for desenhado, o valor retornado será zero.

Comentários

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 se estende na direção do desenho atual do ponto em que cruza o radial do centro do retângulo delimitador até o ponto (nXStartArc, nYStartArc). O arco termina onde cruza o radial do centro do retângulo delimitador para o ponto (nXEndArc, nYEndArc). Se o ponto de partida e o ponto final forem os mesmos, uma elipse completa será desenhada.

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

A posição atual não é usada nem atualizada pelo Arc.

Use as funções GetArcDirection e SetArcDirection para obter e definir a direção de desenho atual para um contexto de dispositivo. A direção de desenho padrão é no sentido anti-horário.

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