Graphics.DrawEllipse Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Desenha uma reticência definida por um retângulo delimitador especificado por um par de coordenadas, uma altura e uma largura.

Sobrecargas

DrawEllipse(Pen, Int32, Int32, Int32, Int32)	Desenha uma elipse definida por um retângulo delimitador especificado por coordenadas para o canto superior esquerdo do retângulo, uma altura e uma largura.
DrawEllipse(Pen, Single, Single, Single, Single)	Desenha uma reticência definida por um retângulo delimitador especificado por um par de coordenadas, uma altura e uma largura.
DrawEllipse(Pen, RectangleF)	Desenha uma reticência definida por um RectangleFdelimitadora.
DrawEllipse(Pen, Rectangle)	Desenha uma reticência especificada por uma estrutura de Rectangle delimitado.

DrawEllipse(Pen, Int32, Int32, Int32, Int32)

Desenha uma elipse definida por um retângulo delimitador especificado por coordenadas para o canto superior esquerdo do retângulo, uma altura e uma largura.

public:
 void DrawEllipse(System::Drawing::Pen ^ pen, int x, int y, int width, int height);

public void DrawEllipse (System.Drawing.Pen pen, int x, int y, int width, int height);

member this.DrawEllipse : System.Drawing.Pen * int * int * int * int -> unit

Public Sub DrawEllipse (pen As Pen, x As Integer, y As Integer, width As Integer, height As Integer)

Parâmetros

pen

Pen

Pen que determina a cor, a largura e o estilo das reticências.

x

Int32

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

y

Int32

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

width

Int32

Largura do retângulo delimitador que define a elipse.

height

Int32

Altura do retângulo delimitador que define a elipse.

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.

• Desenha a elipse para a tela.

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

      // Create location and size of ellipse.
      int x = 0;
      int y = 0;
      int width = 200;
      int height = 100;

      // Draw ellipse to screen.
      e->Graphics->DrawEllipse( blackPen, x, y, width, height );
   }

private void DrawEllipseInt(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of ellipse.
    int x = 0;
    int y = 0;
    int width = 200;
    int height = 100;
             
    // Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, x, y, width, height);
}

Private Sub DrawEllipseInt(ByVal e As PaintEventArgs)

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

    ' Create location and size of ellipse.
    Dim x As Integer = 0
    Dim y As Integer = 0
    Dim width As Integer = 200
    Dim height As Integer = 100

    ' Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, x, y, width, height)
End Sub

Comentários

Esse método desenha uma elipse definida pelo retângulo delimitador descrito pelos parâmetros x, y, widthe height.

DrawEllipse(Pen, Single, Single, Single, Single)

Desenha uma reticência definida por um retângulo delimitador especificado por um par de coordenadas, uma altura e uma largura.

public:
 void DrawEllipse(System::Drawing::Pen ^ pen, float x, float y, float width, float height);

public void DrawEllipse (System.Drawing.Pen pen, float x, float y, float width, float height);

member this.DrawEllipse : System.Drawing.Pen * single * single * single * single -> unit

Public Sub DrawEllipse (pen As Pen, x As Single, y As Single, width As Single, height As Single)

Parâmetros

pen

Pen

Pen que determina a cor, a largura e o estilo das reticências.

x

Single

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

y

Single

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

width

Single

Largura do retângulo delimitador que define a elipse.

height

Single

Altura do retângulo delimitador que define a elipse.

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.

• Desenha a elipse para a tela.

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

      // Create location and size of ellipse.
      float x = 0.0F;
      float y = 0.0F;
      float width = 200.0F;
      float height = 100.0F;

      // Draw ellipse to screen.
      e->Graphics->DrawEllipse( blackPen, x, y, width, height );
   }

private void DrawEllipseFloat(PaintEventArgs e)
{         
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of ellipse.
    float x = 0.0F;
    float y = 0.0F;
    float width = 200.0F;
    float height = 100.0F;
             
    // Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, x, y, width, height);
}

Private Sub DrawEllipseFloat(ByVal e As PaintEventArgs)

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

    ' Create location and size of ellipse.
    Dim x As Single = 0.0F
    Dim y As Single = 0.0F
    Dim width As Single = 200.0F
    Dim height As Single = 100.0F

    ' Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, x, y, width, height)
End Sub

Comentários

Esse método desenha uma elipse definida pelo retângulo delimitador descrito pelos parâmetros x, y, widthe height.

DrawEllipse(Pen, RectangleF)

Desenha uma reticência definida por um RectangleFdelimitadora.

public:
 void DrawEllipse(System::Drawing::Pen ^ pen, System::Drawing::RectangleF rect);

public void DrawEllipse (System.Drawing.Pen pen, System.Drawing.RectangleF rect);

member this.DrawEllipse : System.Drawing.Pen * System.Drawing.RectangleF -> unit

Public Sub DrawEllipse (pen As Pen, rect As RectangleF)

Parâmetros

pen

Pen

Pen que determina a cor, a largura e o estilo das reticências.

rect

RectangleF

RectangleF estrutura que define os limites da elipse.

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.

• Desenha a elipse para a tela.

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

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

      // Draw ellipse to screen.
      e->Graphics->DrawEllipse( blackPen, rect );
   }

private void DrawEllipseRectangleF(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create rectangle for ellipse.
    RectangleF rect = new RectangleF(0.0F, 0.0F, 200.0F, 100.0F);
             
    // Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, rect);
}

Private Sub DrawEllipseRectangleF(ByVal e As PaintEventArgs)

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

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

    ' Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, rect)
End Sub

Comentários

Esse método desenha uma elipse definida pelo retângulo delimitador especificado pelo parâmetro rect.

DrawEllipse(Pen, Rectangle)

Desenha uma reticência especificada por uma estrutura de Rectangle delimitado.

public:
 void DrawEllipse(System::Drawing::Pen ^ pen, System::Drawing::Rectangle rect);

public void DrawEllipse (System.Drawing.Pen pen, System.Drawing.Rectangle rect);

member this.DrawEllipse : System.Drawing.Pen * System.Drawing.Rectangle -> unit

Public Sub DrawEllipse (pen As Pen, rect As Rectangle)

Parâmetros

pen

Pen

Pen que determina a cor, a largura e o estilo das reticências.

rect

Rectangle

Rectangle estrutura que define os limites da elipse.

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.

• Desenha a elipse para a tela.

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

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

      // Draw ellipse to screen.
      e->Graphics->DrawEllipse( blackPen, rect );
   }

private void DrawEllipseRectangle(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create rectangle for ellipse.
    Rectangle rect = new Rectangle(0, 0, 200, 100);
             
    // Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, rect);
}

Private Sub DrawEllipseRectangle(ByVal e As PaintEventArgs)

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

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

    ' Draw ellipse to screen.
    e.Graphics.DrawEllipse(blackPen, rect)
End Sub

Comentários

Esse método desenha uma elipse definida pelo retângulo delimitador especificado pelo parâmetro rect.