GraphicsPath.AddArc Método

Definição

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Acrescenta um arco elíptico à figura atual.

Sobrecargas

AddArc(Single, Single, Single, Single, Single, Single)	Acrescenta um arco elíptico à figura atual.
AddArc(Int32, Int32, Int32, Int32, Single, Single)	Acrescenta um arco elíptico à figura atual.
AddArc(Rectangle, Single, Single)	Acrescenta um arco elíptico à figura atual.
AddArc(RectangleF, Single, Single)	Acrescenta um arco elíptico à figura atual.

AddArc(Single, Single, Single, Single, Single, Single)

Acrescenta um arco elíptico à figura atual.

public:
 void AddArc(float x, float y, float width, float height, float startAngle, float sweepAngle);

public void AddArc (float x, float y, float width, float height, float startAngle, float sweepAngle);

member this.AddArc : single * single * single * single * single * single -> unit

Public Sub AddArc (x As Single, y As Single, width As Single, height As Single, startAngle As Single, sweepAngle As Single)

Parâmetros

x

Single

A coordenada x do canto superior esquerdo da região retangular que define a elipse da qual o arco é desenhado.

y

Single

A coordenada y do canto superior esquerdo da região retangular que define a elipse da qual o arco é desenhado.

width

Single

A largura da região retangular que define a elipse da qual o arco é desenhado.

height

Single

A altura da região retangular que define a elipse da qual o arco é desenhado.

startAngle

Single

O ângulo inicial do arco, medido em graus no sentido horário do eixo x.

sweepAngle

Single

O ângulo entre startAngle e o final do arco.

Exemplos

Para obter um exemplo, consulte AddArc(Rectangle, Single, Single).

Comentários

Se houver linhas ou curvas anteriores na figura, uma linha será adicionada para conectar o ponto de extremidade do segmento anterior ao início do arco.

O arco é rastreado ao longo do perímetro da elipse delimitada pelo retângulo especificado. O ponto inicial do arco é determinado medindo o sentido horário do eixo x da elipse (no ângulo de 0 grau) pelo número de graus no ângulo inicial. O ponto de extremidade é localizado da mesma forma medindo o sentido horário do ponto inicial pelo número de graus no ângulo de varredura. Se o ângulo de varredura for maior que 360 graus ou menor que -360 graus, o arco será varrido por exatamente 360 graus ou -360 graus, respectivamente.

AddArc(Int32, Int32, Int32, Int32, Single, Single)

Acrescenta um arco elíptico à figura atual.

public:
 void AddArc(int x, int y, int width, int height, float startAngle, float sweepAngle);

public void AddArc (int x, int y, int width, int height, float startAngle, float sweepAngle);

member this.AddArc : int * int * int * int * single * single -> unit

Public Sub AddArc (x As Integer, y As Integer, width As Integer, height As Integer, startAngle As Single, sweepAngle As Single)

Parâmetros

x

Int32

A coordenada x do canto superior esquerdo da região retangular que define a elipse da qual o arco é desenhado.

y

Int32

A coordenada y do canto superior esquerdo da região retangular que define a elipse da qual o arco é desenhado.

width

Int32

A largura da região retangular que define a elipse da qual o arco é desenhado.

height

Int32

A altura da região retangular que define a elipse da qual o arco é desenhado.

startAngle

Single

O ângulo inicial do arco, medido em graus no sentido horário do eixo x.

sweepAngle

Single

O ângulo entre startAngle e o final do arco.

Exemplos

Para obter um exemplo, consulte AddArc(Rectangle, Single, Single).

Comentários

Se houver linhas ou curvas anteriores na figura, uma linha será adicionada para conectar o ponto de extremidade do segmento anterior ao início do arco.

O arco é rastreado ao longo do perímetro da elipse delimitada pelo retângulo especificado. O ponto inicial do arco é determinado medindo o sentido horário do eixo x da elipse (no ângulo de 0 grau) pelo número de graus no ângulo inicial. O ponto de extremidade é localizado da mesma forma medindo o sentido horário do ponto inicial pelo número de graus no ângulo de varredura. Se o ângulo de varredura for maior que 360 graus ou menor que -360 graus, o arco será varrido por exatamente 360 graus ou -360 graus, respectivamente.

AddArc(Rectangle, Single, Single)

Acrescenta um arco elíptico à figura atual.

public:
 void AddArc(System::Drawing::Rectangle rect, float startAngle, float sweepAngle);

public void AddArc (System.Drawing.Rectangle rect, float startAngle, float sweepAngle);

member this.AddArc : System.Drawing.Rectangle * single * single -> unit

Public Sub AddArc (rect As Rectangle, startAngle As Single, sweepAngle As Single)

Parâmetros

rect

Rectangle

Um Rectangle que representa os limites retangulares da elipse da qual o arco é tirado.

startAngle

Single

O ângulo inicial do arco, medido em graus no sentido horário do eixo x.

sweepAngle

Single

O ângulo entre startAngle e o final do arco.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, um objeto de evento OnPaint. O código executa as seguintes ações:

• Cria um retângulo, do qual o arco é definido.

• Cria um caminho, myPath.

• Define um arco elíptico de 180 graus que varre de 0 graus a 180 graus e acrescenta-o a um caminho.

• Desenha o caminho para a tela.

private:
   void AddArcExample( PaintEventArgs^ e )
   {
      // Create a GraphicsPath object.
      GraphicsPath^ myPath = gcnew GraphicsPath;

      // Set up and call AddArc, and close the figure.
      Rectangle rect = Rectangle(20,20,50,100);
      myPath->StartFigure();
      myPath->AddArc( rect, 0, 180 );
      myPath->CloseFigure();

      // Draw the path to screen.
      e->Graphics->DrawPath( gcnew Pen( Color::Red,3.0f ), myPath );
   }

private void AddArcExample(PaintEventArgs e)
{
             
    // Create a GraphicsPath object.
    GraphicsPath myPath = new GraphicsPath();
             
    // Set up and call AddArc, and close the figure.
    Rectangle rect = new Rectangle(20, 20, 50, 100);
    myPath.StartFigure();
    myPath.AddArc(rect, 0, 180);
    myPath.CloseFigure();
             
    // Draw the path to screen.
    e.Graphics.DrawPath(new Pen(Color.Red, 3), myPath);
}

Public Sub AddArcExample(ByVal e As PaintEventArgs)

    ' Create a GraphicsPath object.
    Dim myPath As New GraphicsPath

    ' Set up and call AddArc, and close the figure.
    Dim rect As New Rectangle(20, 20, 50, 100)
    myPath.StartFigure()
    myPath.AddArc(rect, 0, 180)
    myPath.CloseFigure()

    ' Draw the path to screen.
    e.Graphics.DrawPath(New Pen(Color.Red, 3), myPath)
End Sub

Comentários

Se houver linhas ou curvas anteriores na figura, uma linha será adicionada para conectar o ponto de extremidade do segmento anterior ao início do arco.

O arco é rastreado ao longo do perímetro da elipse delimitada pelo retângulo especificado. O ponto inicial do arco é determinado medindo o sentido horário do eixo x da elipse (no ângulo de 0 grau) pelo número de graus no ângulo inicial. O ponto de extremidade é localizado da mesma forma medindo o sentido horário do ponto inicial pelo número de graus no ângulo de varredura. Se o ângulo de varredura for maior que 360 graus ou menor que -360 graus, o arco será varrido por exatamente 360 graus ou -360 graus, respectivamente.

AddArc(RectangleF, Single, Single)

Acrescenta um arco elíptico à figura atual.

public:
 void AddArc(System::Drawing::RectangleF rect, float startAngle, float sweepAngle);

public void AddArc (System.Drawing.RectangleF rect, float startAngle, float sweepAngle);

member this.AddArc : System.Drawing.RectangleF * single * single -> unit

Public Sub AddArc (rect As RectangleF, startAngle As Single, sweepAngle As Single)

Parâmetros

rect

RectangleF

Um RectangleF que representa os limites retangulares da elipse da qual o arco é tirado.

startAngle

Single

O ângulo inicial do arco, medido em graus no sentido horário do eixo x.

sweepAngle

Single

O ângulo entre startAngle e o final do arco.

Exemplos

Para obter um exemplo, consulte AddArc(Rectangle, Single, Single).

Comentários

Se houver linhas ou curvas anteriores na figura, uma linha será adicionada para conectar o ponto de extremidade do segmento anterior ao início do arco.

O arco é rastreado ao longo do perímetro da elipse delimitada pelo retângulo especificado. O ponto inicial do arco é determinado medindo o sentido horário do eixo x da elipse (no ângulo de 0 grau) pelo número de graus no ângulo inicial. O ponto de extremidade é localizado da mesma forma medindo o sentido horário do ponto inicial pelo número de graus no ângulo de varredura. Se o ângulo de varredura for maior que 360 graus ou menor que -360 graus, o arco será varrido por exatamente 360 graus ou -360 graus, respectivamente.