Graphics.DrawArc Método

Definição

Desenha um arco que representa uma parte de uma elipse especificada por um par de coordenadas, uma largura ou uma altura.

Sobrecargas

DrawArc(Pen, Rectangle, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura Rectangle.

DrawArc(Pen, RectangleF, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura RectangleF.

DrawArc(Pen, Int32, Int32, Int32, Int32, Int32, Int32)

Desenha um arco que representa uma parte de uma elipse especificada por um par de coordenadas, uma largura ou uma altura.

DrawArc(Pen, Single, Single, Single, Single, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por um par de coordenadas, uma largura ou uma altura.

DrawArc(Pen, Rectangle, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura Rectangle.

public:
 void DrawArc(System::Drawing::Pen ^ pen, System::Drawing::Rectangle rect, float startAngle, float sweepAngle);
public void DrawArc (System.Drawing.Pen pen, System.Drawing.Rectangle rect, float startAngle, float sweepAngle);
member this.DrawArc : System.Drawing.Pen * System.Drawing.Rectangle * single * single -> unit
Public Sub DrawArc (pen As Pen, rect As Rectangle, startAngle As Single, sweepAngle As Single)

Parâmetros

pen
Pen

Pen que determina a cor, a largura e o estilo do arco.

rect
Rectangle

Estrutura RectangleF que define os limites da elipse.

startAngle
Single

Ângulo em graus medido no sentido horário do eixo x ao ponto de partida do arco.

sweepAngle
Single

Ângulo em graus medido no sentido horário do parâmetro startAngle ao ponto de término do arco.

Exceções

pen é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma caneta preta.

  • Cria um retângulo para associar uma elipse.

  • Define os ângulos de início (45 graus) e varredura (270 graus).

  • Desenha o arco elíptico para a tela.

O resultado é uma elipse parcial sem um segmento entre + e - 45 graus do eixo x.

private:
   void DrawArcRectangle( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create rectangle to bound ellipse.
      Rectangle rect = Rectangle(0,0,100,200);

      // Create start and sweep angles on ellipse.
      float startAngle = 45.0F;
      float sweepAngle = 270.0F;

      // Draw arc to screen.
      e->Graphics->DrawArc( blackPen, rect, startAngle, sweepAngle );
   }
private void DrawArcRectangle(PaintEventArgs e)
{
   // Create pen.
    Pen blackPen= new Pen(Color.Black, 3);
             
    // Create rectangle to bound ellipse.
    Rectangle rect = new Rectangle(0, 0, 100, 200);
             
    // Create start and sweep angles on ellipse.
    float startAngle =  45.0F;
    float sweepAngle = 270.0F;
             
    // Draw arc to screen.
    e.Graphics.DrawArc(blackPen, rect, startAngle, sweepAngle);
}
Private Sub DrawArcRectangle(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create rectangle to bound ellipse.
    Dim rect As New Rectangle(0, 0, 100, 200)

    ' Create start and sweep angles on ellipse.
    Dim startAngle As Single = 45.0F
    Dim sweepAngle As Single = 270.0F

    ' Draw arc to screen.
    e.Graphics.DrawArc(blackPen, rect, startAngle, sweepAngle)
End Sub

Comentários

Esse método desenha um arco que é uma parte do perímetro de uma elipse. A elipse é definida pelos limites de um retângulo. O arco é a parte do perímetro da elipse entre o startAngle parâmetro e os startAngle + sweepAngle parâmetros.

Aplica-se a

DrawArc(Pen, RectangleF, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura RectangleF.

public:
 void DrawArc(System::Drawing::Pen ^ pen, System::Drawing::RectangleF rect, float startAngle, float sweepAngle);
public void DrawArc (System.Drawing.Pen pen, System.Drawing.RectangleF rect, float startAngle, float sweepAngle);
member this.DrawArc : System.Drawing.Pen * System.Drawing.RectangleF * single * single -> unit
Public Sub DrawArc (pen As Pen, rect As RectangleF, startAngle As Single, sweepAngle As Single)

Parâmetros

pen
Pen

Pen que determina a cor, a largura e o estilo do arco.

rect
RectangleF

Estrutura RectangleF que define os limites da elipse.

startAngle
Single

Ângulo em graus medido no sentido horário do eixo x ao ponto de partida do arco.

sweepAngle
Single

Ângulo em graus medido no sentido horário do parâmetro startAngle ao ponto de término do arco.

Exceções

pen é null

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma caneta preta.

  • Cria um retângulo para associar uma elipse.

  • Define os ângulos de início (45 graus) e varredura (270 graus).

  • Desenha o arco elíptico para a tela.

O resultado é uma elipse parcial sem um segmento entre + e - 45 graus do eixo x.

private:
   void DrawArcRectangleF( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create rectangle to bound ellipse.
      RectangleF rect = RectangleF(0.0F,0.0F,100.0F,200.0F);

      // Create start and sweep angles on ellipse.
      float startAngle = 45.0F;
      float sweepAngle = 270.0F;

      // Draw arc to screen.
      e->Graphics->DrawArc( blackPen, rect, startAngle, sweepAngle );
   }
private void DrawArcRectangleF(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen= new Pen(Color.Black, 3);
             
    // Create rectangle to bound ellipse.
    RectangleF rect = new RectangleF(0.0F, 0.0F, 100.0F, 200.0F);
             
    // Create start and sweep angles on ellipse.
    float startAngle =  45.0F;
    float sweepAngle = 270.0F;
             
    // Draw arc to screen.
    e.Graphics.DrawArc(blackPen, rect, startAngle, sweepAngle);
}
Private Sub DrawArcRectangleF(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create rectangle to bound ellipse.
    Dim rect As New RectangleF(0.0F, 0.0F, 100.0F, 200.0F)

    ' Create start and sweep angles on ellipse.
    Dim startAngle As Single = 45.0F
    Dim sweepAngle As Single = 270.0F

    ' Draw arc to screen.
    e.Graphics.DrawArc(blackPen, rect, startAngle, sweepAngle)
End Sub

Comentários

Esse método desenha um arco que é uma parte do perímetro de uma elipse. A elipse é definida pelos limites de um retângulo. O arco é a parte do perímetro da elipse entre o startAngle parâmetro e os startAngle + sweepAngle parâmetros.

Aplica-se a

DrawArc(Pen, Int32, Int32, Int32, Int32, Int32, Int32)

Desenha um arco que representa uma parte de uma elipse especificada por um par de coordenadas, uma largura ou uma altura.

public:
 void DrawArc(System::Drawing::Pen ^ pen, int x, int y, int width, int height, int startAngle, int sweepAngle);
public void DrawArc (System.Drawing.Pen pen, int x, int y, int width, int height, int startAngle, int sweepAngle);
member this.DrawArc : System.Drawing.Pen * int * int * int * int * int * int -> unit
Public Sub DrawArc (pen As Pen, x As Integer, y As Integer, width As Integer, height As Integer, startAngle As Integer, sweepAngle As Integer)

Parâmetros

pen
Pen

Pen que determina a cor, a largura e o estilo do arco.

x
Int32

A coordenada X do canto superior esquerdo do retângulo que define a elipse.

y
Int32

A coordenada y do canto superior esquerdo do retângulo que define a elipse.

width
Int32

Largura do retângulo que define a elipse.

height
Int32

Altura do retângulo que define a elipse.

startAngle
Int32

Ângulo em graus medido no sentido horário do eixo x ao ponto de partida do arco.

sweepAngle
Int32

Ângulo em graus medido no sentido horário do parâmetro startAngle ao ponto de término do arco.

Exceções

pen é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma caneta preta.

  • Cria a posição e o tamanho de um retângulo para associar uma elipse.

  • Define os ângulos de início (45 graus) e varredura (270 graus).

  • Desenha o arco elíptico para a tela.

O resultado é uma elipse parcial sem um segmento entre + e - 45 graus do eixo x.

private:
   void DrawArcInt( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );
      // Create coordinates of rectangle to bound ellipse.
      int x = 0;
      int y = 0;
      int width = 100;
      int height = 200;

      // Create start and sweep angles on ellipse.
      int startAngle = 45;
      int sweepAngle = 270;

      // Draw arc to screen.
      e->Graphics->DrawArc( blackPen, x, y, width, height, startAngle, sweepAngle );
   }
private void DrawArcInt(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen= new Pen(Color.Black, 3);
             
    // Create coordinates of rectangle to bound ellipse.
    int x = 0;
    int y = 0;
    int width = 100;
    int height = 200;
             
    // Create start and sweep angles on ellipse.
    int startAngle =  45;
    int sweepAngle = 270;
             
    // Draw arc to screen.
    e.Graphics.DrawArc(blackPen, x, y, width, height, startAngle, sweepAngle);
}
Private Sub DrawArcInt(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create coordinates of rectangle to bound ellipse.
    Dim x As Integer = 0
    Dim y As Integer = 0
    Dim width As Integer = 100
    Dim height As Integer = 200

    ' Create start and sweep angles on ellipse.
    Dim startAngle As Integer = 45
    Dim sweepAngle As Integer = 270

    ' Draw arc to screen.
    e.Graphics.DrawArc(blackPen, x, y, width, height, startAngle, _
    sweepAngle)
End Sub

Comentários

Esse método desenha um arco que é uma parte do perímetro de uma elipse. A elipse é definida pelos limites de um retângulo. O arco é a parte do perímetro da elipse entre o startAngle parâmetro e os startAngle + sweepAngle parâmetros.

Aplica-se a

DrawArc(Pen, Single, Single, Single, Single, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por um par de coordenadas, uma largura ou uma altura.

public:
 void DrawArc(System::Drawing::Pen ^ pen, float x, float y, float width, float height, float startAngle, float sweepAngle);
public void DrawArc (System.Drawing.Pen pen, float x, float y, float width, float height, float startAngle, float sweepAngle);
member this.DrawArc : System.Drawing.Pen * single * single * single * single * single * single -> unit
Public Sub DrawArc (pen As Pen, x As Single, y As Single, width As Single, height As Single, startAngle As Single, sweepAngle As Single)

Parâmetros

pen
Pen

Pen que determina a cor, a largura e o estilo do arco.

x
Single

A coordenada X do canto superior esquerdo do retângulo que define a elipse.

y
Single

A coordenada y do canto superior esquerdo do retângulo que define a elipse.

width
Single

Largura do retângulo que define a elipse.

height
Single

Altura do retângulo que define a elipse.

startAngle
Single

Ângulo em graus medido no sentido horário do eixo x ao ponto de partida do arco.

sweepAngle
Single

Ângulo em graus medido no sentido horário do parâmetro startAngle ao ponto de término do arco.

Exceções

pen é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma caneta preta.

  • Cria a posição e o tamanho de um retângulo para associar uma elipse.

  • Define os ângulos de início (45 graus) e varredura (270 graus).

  • Desenha o arco elíptico para a tela.

O resultado é uma elipse parcial sem um segmento entre + e - 45 graus do eixo x.

private:
   void DrawArcFloat( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create coordinates of rectangle to bound ellipse.
      float x = 0.0F;
      float y = 0.0F;
      float width = 100.0F;
      float height = 200.0F;

      // Create start and sweep angles on ellipse.
      float startAngle = 45.0F;
      float sweepAngle = 270.0F;

      // Draw arc to screen.
      e->Graphics->DrawArc( blackPen, x, y, width, height, startAngle, sweepAngle );
   }
private void DrawArcFloat(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen= new Pen(Color.Black, 3);
             
    // Create coordinates of rectangle to bound ellipse.
    float x = 0.0F;
    float y = 0.0F;
    float width = 100.0F;
    float height = 200.0F;
             
    // Create start and sweep angles on ellipse.
    float startAngle =  45.0F;
    float sweepAngle = 270.0F;
             
    // Draw arc to screen.
    e.Graphics.DrawArc(blackPen, x, y, width, height, startAngle, sweepAngle);
}
Private Sub DrawArcFloat(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create coordinates of rectangle to bound ellipse.
    Dim x As Single = 0.0F
    Dim y As Single = 0.0F
    Dim width As Single = 100.0F
    Dim height As Single = 200.0F

    ' Create start and sweep angles on ellipse.
    Dim startAngle As Single = 45.0F
    Dim sweepAngle As Single = 270.0F

    ' Draw arc to screen.
    e.Graphics.DrawArc(blackPen, x, y, width, height, startAngle, _
    sweepAngle)
End Sub

Comentários

Esse método desenha um arco que é uma parte do perímetro de uma elipse. A elipse é definida pelos limites de um retângulo. O arco é a parte do perímetro da elipse entre o startAngle parâmetro e os startAngle + sweepAngle parâmetros.

Aplica-se a