Graphics.DrawArc Método

Referência

Definição

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Pacote:: System.Drawing.Common v8.0.10

Pacote:: System.Drawing.Common v9.0.0-rc.2.24474.1

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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)

Origem:: Graphics.cs

Origem:: Graphics.cs

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.

Aplica-se a

DrawArc(Pen, RectangleF, Single, Single)

Origem:: Graphics.cs

Origem:: Graphics.cs

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

Aplica-se a

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

Origem:: Graphics.cs

Origem:: Graphics.cs

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

Aplica-se a

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

Origem:: Graphics.cs

Origem:: Graphics.cs

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

Aplica-se a

Partilhar via

Graphics.DrawArc Método

Definição

Sobrecargas

DrawArc(Pen, Rectangle, Single, Single)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

DrawArc(Pen, RectangleF, Single, Single)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Recursos adicionais