Graphics.DrawEllipse Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Draws an ellipse defined by a bounding rectangle specified by a pair of coordinates, a height, and a width.

Overloads

DrawEllipse(Pen, Int32, Int32, Int32, Int32)	Draws an ellipse defined by a bounding rectangle specified by coordinates for the upper-left corner of the rectangle, a height, and a width.
DrawEllipse(Pen, Single, Single, Single, Single)	Draws an ellipse defined by a bounding rectangle specified by a pair of coordinates, a height, and a width.
DrawEllipse(Pen, RectangleF)	Draws an ellipse defined by a bounding RectangleF.
DrawEllipse(Pen, Rectangle)	Draws an ellipse specified by a bounding Rectangle structure.

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

Draws an ellipse defined by a bounding rectangle specified by coordinates for the upper-left corner of the rectangle, a height, and a width.

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)

Parameters

pen

Pen

Pen that determines the color, width, and style of the ellipse.

x

Int32

The x-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse.

y

Int32

The y-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse.

width

Int32

Width of the bounding rectangle that defines the ellipse.

height

Int32

Height of the bounding rectangle that defines the ellipse.

Exceptions

ArgumentNullException

pen is null.

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

• Creates a black pen.

• Creates the position and size of a rectangle to bound an ellipse.

• Draws the ellipse to the screen.

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

Remarks

This method draws an ellipse that is defined by the bounding rectangle described by the x, y, width, and height parameters.

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

Draws an ellipse defined by a bounding rectangle specified by a pair of coordinates, a height, and a width.

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)

Parameters

pen

Pen

Pen that determines the color, width, and style of the ellipse.

x

Single

The x-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse.

y

Single

The y-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse.

width

Single

Width of the bounding rectangle that defines the ellipse.

height

Single

Height of the bounding rectangle that defines the ellipse.

Exceptions

ArgumentNullException

pen is null.

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

• Creates a black pen.

• Creates the position and size of a rectangle to bound an ellipse.

• Draws the ellipse to the screen.

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

Remarks

This method draws an ellipse that is defined by the bounding rectangle described by the x, y, width, and height parameters.

DrawEllipse(Pen, RectangleF)

Draws an ellipse defined by a bounding RectangleF.

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)

Parameters

pen

Pen

Pen that determines the color, width, and style of the ellipse.

rect

RectangleF

RectangleF structure that defines the boundaries of the ellipse.

Exceptions

ArgumentNullException

pen is null.

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

• Creates a black pen.

• Creates a rectangle to bound an ellipse.

• Draws the ellipse to the screen.

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

Remarks

This method draws an ellipse that is defined by the bounding rectangle specified by the rect parameter.

DrawEllipse(Pen, Rectangle)

Draws an ellipse specified by a bounding Rectangle structure.

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)

Parameters

pen

Pen

Pen that determines the color, width, and style of the ellipse.

rect

Rectangle

Rectangle structure that defines the boundaries of the ellipse.

Exceptions

ArgumentNullException

pen is null.

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

• Creates a black pen.

• Creates a rectangle to bound an ellipse.

• Draws the ellipse to the screen.

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

Remarks

This method draws an ellipse that is defined by the bounding rectangle specified by the rect parameter.