Graphics.DrawArc Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

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

Sobrecargas

DrawArc(Pen, Rectangle, Single, Single)	Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura de Rectangle.
DrawArc(Pen, RectangleF, Single, Single)	Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura de 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 e 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 e uma altura.

DrawArc(Pen, Rectangle, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura de 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

RectangleF estrutura que define os limites da elipse.

startAngle

Single

Ângulo em graus medido no sentido horário do eixo x até o ponto inicial do arco.

sweepAngle

Single

Ângulo em graus medido no sentido horário do parâmetro startAngle até o ponto final do arco.

Exceções

ArgumentNullException

pen é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 que não tem 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 reticência é definida pelos limites de um retângulo. O arco é a parte do perímetro da reticência entre o parâmetro startAngle e os parâmetros startAngle + sweepAngle.

DrawArc(Pen, RectangleF, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura de 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

RectangleF estrutura que define os limites da elipse.

startAngle

Single

Ângulo em graus medido no sentido horário do eixo x até o ponto inicial do arco.

sweepAngle

Single

Ângulo em graus medido no sentido horário do parâmetro startAngle até o ponto final do arco.

Exceções

ArgumentNullException

pen está null

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 que não tem 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 reticência é definida pelos limites de um retângulo. O arco é a parte do perímetro da reticência entre o parâmetro startAngle e os parâmetros startAngle + sweepAngle.

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 e 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 até o ponto inicial do arco.

sweepAngle

Int32

Ângulo em graus medido no sentido horário do parâmetro startAngle até o ponto final do arco.

Exceções

ArgumentNullException

pen é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 que não tem 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 reticência é definida pelos limites de um retângulo. O arco é a parte do perímetro da reticência entre o parâmetro startAngle e os parâmetros startAngle + sweepAngle.

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 e 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 até o ponto inicial do arco.

sweepAngle

Single

Ângulo em graus medido no sentido horário do parâmetro startAngle até o ponto final do arco.

Exceções

ArgumentNullException

pen é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 que não tem 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 reticência é definida pelos limites de um retângulo. O arco é a parte do perímetro da reticência entre o parâmetro startAngle e os parâmetros startAngle + sweepAngle.