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.Draws an arc representing a portion of an ellipse specified by a pair of coordinates, a width, and a height.

Sobrecargas

DrawArc(Pen, Rectangle, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura Rectangle.Draws an arc representing a portion of an ellipse specified by a Rectangle structure.

DrawArc(Pen, RectangleF, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura RectangleF.Draws an arc representing a portion of an ellipse specified by a RectangleF structure.

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.Draws an arc representing a portion of an ellipse specified by a pair of coordinates, a width, and a height.

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.Draws an arc representing a portion of an ellipse specified by a pair of coordinates, a width, and a height.

DrawArc(Pen, Rectangle, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura Rectangle.Draws an arc representing a portion of an ellipse specified by a Rectangle structure.

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.Pen that determines the color, width, and style of the arc.

rect
Rectangle

Estrutura RectangleF que define os limites da elipse.RectangleF structure that defines the boundaries of the ellipse.

startAngle
Single

Ângulo em graus medido no sentido horário do eixo x ao ponto de partida do arco.Angle in degrees measured clockwise from the x-axis to the starting point of the arc.

sweepAngle
Single

Ângulo em graus medido no sentido horário do parâmetro startAngle ao ponto de término do arco.Angle in degrees measured clockwise from the startAngle parameter to ending point of the arc.

Exceções

pen é null.pen is null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms, e ele requer PaintEventArgs e , que é um parâmetro do Paint manipulador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. O código executa as seguintes ações:The code performs the following actions:

  • Cria uma caneta preta.Creates a black pen.

  • Cria um retângulo para associar uma elipse.Creates a rectangle to bound an ellipse.

  • Define os ângulos de início (45 graus) e de limpeza (270 graus).Defines the start (45 degrees) and sweep (270 degrees) angles.

  • Desenha o arco elíptico na tela.Draws the elliptical arc to the screen.

O resultado é que uma elipse parcial não tem um segmento entre os graus + e-45 do eixo x.The result is a partial ellipse missing a segment between + and - 45 degrees of the x axis.

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.This method draws an arc that is a portion of the perimeter of an ellipse. A elipse é definida pelos limites de um retângulo.The ellipse is defined by the boundaries of a rectangle. O arco é a parte do perímetro da elipse entre o startAngle parâmetro e os startAngle + sweepAngle parâmetros.The arc is the portion of the perimeter of the ellipse between the startAngle parameter and the startAngle + sweepAngle parameters.

Aplica-se a

DrawArc(Pen, RectangleF, Single, Single)

Desenha um arco que representa uma parte de uma elipse especificada por uma estrutura RectangleF.Draws an arc representing a portion of an ellipse specified by a RectangleF structure.

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.Pen that determines the color, width, and style of the arc.

rect
RectangleF

Estrutura RectangleF que define os limites da elipse.RectangleF structure that defines the boundaries of the ellipse.

startAngle
Single

Ângulo em graus medido no sentido horário do eixo x ao ponto de partida do arco.Angle in degrees measured clockwise from the x-axis to the starting point of the arc.

sweepAngle
Single

Ângulo em graus medido no sentido horário do parâmetro startAngle ao ponto de término do arco.Angle in degrees measured clockwise from the startAngle parameter to ending point of the arc.

Exceções

pen é nullpen is null

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms, e ele requer PaintEventArgs e , que é um parâmetro do Paint manipulador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. O código executa as seguintes ações:The code performs the following actions:

  • Cria uma caneta preta.Creates a black pen.

  • Cria um retângulo para associar uma elipse.Creates a rectangle to bound an ellipse.

  • Define os ângulos de início (45 graus) e de limpeza (270 graus).Defines the start (45 degrees) and sweep (270 degrees) angles.

  • Desenha o arco elíptico na tela.Draws the elliptical arc to the screen.

O resultado é que uma elipse parcial não tem um segmento entre os graus + e-45 do eixo x.The result is a partial ellipse missing a segment between + and - 45 degrees of the x axis.

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.This method draws an arc that is a portion of the perimeter of an ellipse. A elipse é definida pelos limites de um retângulo.The ellipse is defined by the boundaries of a rectangle. O arco é a parte do perímetro da elipse entre o startAngle parâmetro e os startAngle + sweepAngle parâmetros.The arc is the portion of the perimeter of the ellipse between the startAngle parameter and the startAngle + sweepAngle parameters.

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.Draws an arc representing a portion of an ellipse specified by a pair of coordinates, a width, and a height.

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.Pen that determines the color, width, and style of the arc.

x
Int32

A coordenada X do canto superior esquerdo do retângulo que define a elipse.The x-coordinate of the upper-left corner of the rectangle that defines the ellipse.

y
Int32

A coordenada y do canto superior esquerdo do retângulo que define a elipse.The y-coordinate of the upper-left corner of the rectangle that defines the ellipse.

width
Int32

Largura do retângulo que define a elipse.Width of the rectangle that defines the ellipse.

height
Int32

Altura do retângulo que define a elipse.Height of the rectangle that defines the ellipse.

startAngle
Int32

Ângulo em graus medido no sentido horário do eixo x ao ponto de partida do arco.Angle in degrees measured clockwise from the x-axis to the starting point of the arc.

sweepAngle
Int32

Ângulo em graus medido no sentido horário do parâmetro startAngle ao ponto de término do arco.Angle in degrees measured clockwise from the startAngle parameter to ending point of the arc.

Exceções

pen é null.pen is null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms, e ele requer PaintEventArgs e , que é um parâmetro do Paint manipulador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. O código executa as seguintes ações:The code performs the following actions:

  • Cria uma caneta preta.Creates a black pen.

  • Cria a posição e o tamanho de um retângulo para associar uma elipse.Creates the position and size of a rectangle to bound an ellipse.

  • Define os ângulos de início (45 graus) e de limpeza (270 graus).Defines the start (45 degrees) and sweep (270 degrees) angles.

  • Desenha o arco elíptico na tela.Draws the elliptical arc to the screen.

O resultado é que uma elipse parcial não tem um segmento entre os graus + e-45 do eixo x.The result is a partial ellipse missing a segment between + and - 45 degrees of the x axis.

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.This method draws an arc that is a portion of the perimeter of an ellipse. A elipse é definida pelos limites de um retângulo.The ellipse is defined by the boundaries of a rectangle. O arco é a parte do perímetro da elipse entre o startAngle parâmetro e os startAngle + sweepAngle parâmetros.The arc is the portion of the perimeter of the ellipse between the startAngle parameter and the startAngle + sweepAngle parameters.

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.Draws an arc representing a portion of an ellipse specified by a pair of coordinates, a width, and a height.

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.Pen that determines the color, width, and style of the arc.

x
Single

A coordenada X do canto superior esquerdo do retângulo que define a elipse.The x-coordinate of the upper-left corner of the rectangle that defines the ellipse.

y
Single

A coordenada y do canto superior esquerdo do retângulo que define a elipse.The y-coordinate of the upper-left corner of the rectangle that defines the ellipse.

width
Single

Largura do retângulo que define a elipse.Width of the rectangle that defines the ellipse.

height
Single

Altura do retângulo que define a elipse.Height of the rectangle that defines the ellipse.

startAngle
Single

Ângulo em graus medido no sentido horário do eixo x ao ponto de partida do arco.Angle in degrees measured clockwise from the x-axis to the starting point of the arc.

sweepAngle
Single

Ângulo em graus medido no sentido horário do parâmetro startAngle ao ponto de término do arco.Angle in degrees measured clockwise from the startAngle parameter to ending point of the arc.

Exceções

pen é null.pen is null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms, e ele requer PaintEventArgs e , que é um parâmetro do Paint manipulador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. O código executa as seguintes ações:The code performs the following actions:

  • Cria uma caneta preta.Creates a black pen.

  • Cria a posição e o tamanho de um retângulo para associar uma elipse.Creates the position and size of a rectangle to bound an ellipse.

  • Define os ângulos de início (45 graus) e de limpeza (270 graus).Defines the start (45 degrees) and sweep (270 degrees) angles.

  • Desenha o arco elíptico na tela.Draws the elliptical arc to the screen.

O resultado é que uma elipse parcial não tem um segmento entre os graus + e-45 do eixo x.The result is a partial ellipse missing a segment between + and - 45 degrees of the x axis.

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.This method draws an arc that is a portion of the perimeter of an ellipse. A elipse é definida pelos limites de um retângulo.The ellipse is defined by the boundaries of a rectangle. O arco é a parte do perímetro da elipse entre o startAngle parâmetro e os startAngle + sweepAngle parâmetros.The arc is the portion of the perimeter of the ellipse between the startAngle parameter and the startAngle + sweepAngle parameters.

Aplica-se a