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)

Рисует эллипс, определяемый ограничивающей структурой Rectangle.Draws an ellipse specified by a bounding Rectangle structure.

DrawEllipse(Pen, RectangleF)

Рисует эллипс, определяемый ограничивающей структурой RectangleF.Draws an ellipse defined by a bounding RectangleF.

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, Rectangle)

Рисует эллипс, определяемый ограничивающей структурой 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, определяющая цвет, ширину и стиль эллипса.Pen that determines the color, width, and style of the ellipse.

rect
Rectangle

Структура Rectangle, определяющая границы эллипса.Rectangle structure that defines the boundaries of the ellipse.

Exceptions

Параметр pen равен null.pen is null.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.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

Этот метод рисует эллипс, определяемый ограничивающим прямоугольником, заданным параметром rect.This method draws an ellipse that is defined by the bounding rectangle specified by the rect parameter.

DrawEllipse(Pen, RectangleF)

Рисует эллипс, определяемый ограничивающей структурой 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, определяющая цвет, ширину и стиль эллипса.Pen that determines the color, width, and style of the ellipse.

rect
RectangleF

Структура RectangleF, определяющая границы эллипса.RectangleF structure that defines the boundaries of the ellipse.

Exceptions

Параметр pen равен null.pen is null.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.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

Этот метод рисует эллипс, определяемый ограничивающим прямоугольником, заданным параметром rect.This method draws an ellipse that is defined by the bounding rectangle specified by the rect parameter.

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, определяющая цвет, ширину и стиль эллипса.Pen that determines the color, width, and style of the ellipse.

x
Int32

Координата X верхнего левого угла ограничивающего прямоугольника, который определяет эллипс.The x-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse.

y
Int32

Координата Y верхнего левого угла ограничивающего прямоугольника, который определяет эллипс.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

Параметр pen равен null.pen is null.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.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

Этот метод рисует эллипс, определяемый ограничивающим прямоугольником, который описывается параметрами x, y, widthи height.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, определяющая цвет, ширину и стиль эллипса.Pen that determines the color, width, and style of the ellipse.

x
Single

Координата X верхнего левого угла ограничивающего прямоугольника, который определяет эллипс.The x-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse.

y
Single

Координата Y верхнего левого угла ограничивающего прямоугольника, который определяет эллипс.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

Параметр pen равен null.pen is null.

Examples

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.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

Этот метод рисует эллипс, определяемый ограничивающим прямоугольником, который описывается параметрами x, y, widthи height.This method draws an ellipse that is defined by the bounding rectangle described by the x, y, width, and height parameters.

Applies to