Graphics.DrawEllipse Graphics.DrawEllipse Graphics.DrawEllipse Method

Definition

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

Overloads

DrawEllipse(Pen, Rectangle) DrawEllipse(Pen, Rectangle) DrawEllipse(Pen, Rectangle)

Draws an ellipse specified by a bounding Rectangle structure.

DrawEllipse(Pen, RectangleF) DrawEllipse(Pen, RectangleF) DrawEllipse(Pen, RectangleF)

Draws an ellipse defined by a bounding RectangleF.

DrawEllipse(Pen, Int32, Int32, Int32, Int32) DrawEllipse(Pen, Int32, Int32, Int32, Int32) 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) DrawEllipse(Pen, Single, Single, Single, Single) 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, Rectangle) DrawEllipse(Pen, Rectangle) 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

Parameters

pen
Pen Pen Pen

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

rect
Rectangle Rectangle Rectangle

Rectangle structure that defines the boundaries of the ellipse.

Exceptions

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, 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.

DrawEllipse(Pen, RectangleF) DrawEllipse(Pen, RectangleF) 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

Parameters

pen
Pen Pen Pen

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

rect
RectangleF RectangleF RectangleF

RectangleF structure that defines the boundaries of the ellipse.

Exceptions

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, 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, Int32, Int32, Int32, Int32) DrawEllipse(Pen, Int32, Int32, Int32, Int32) 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

Parameters

pen
Pen Pen Pen

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

x
Int32 Int32 Int32

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

y
Int32 Int32 Int32

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

width
Int32 Int32 Int32

Width of the bounding rectangle that defines the ellipse.

height
Int32 Int32 Int32

Height of the bounding rectangle that defines the ellipse.

Exceptions

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, 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) DrawEllipse(Pen, Single, Single, Single, Single) 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

Parameters

pen
Pen Pen Pen

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

x
Single Single Single

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

y
Single Single Single

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

width
Single Single Single

Width of the bounding rectangle that defines the ellipse.

height
Single Single Single

Height of the bounding rectangle that defines the ellipse.

Exceptions

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, 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.

Applies to