Graphics.DrawEllipse Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Zeichnet eine Ellipse, die durch ein begrenzungsfähiges Rechteck definiert wird, das durch ein Koordinatenpaar, eine Höhe und eine Breite angegeben wird.

Überlädt

DrawEllipse(Pen, Int32, Int32, Int32, Int32)	Zeichnet eine Ellipse, die durch ein umgebendes Rechteck definiert wird, das durch Koordinaten für die obere linke Ecke des Rechtecks, einer Höhe und einer Breite angegeben wird.
DrawEllipse(Pen, Single, Single, Single, Single)	Zeichnet eine Ellipse, die durch ein begrenzungsfähiges Rechteck definiert wird, das durch ein Koordinatenpaar, eine Höhe und eine Breite angegeben wird.
DrawEllipse(Pen, RectangleF)	Zeichnet eine durch eine begrenzungsgebundene RectangleFdefinierte Ellipse.
DrawEllipse(Pen, Rectangle)	Zeichnet eine durch eine umgebende Rectangle Struktur angegebene Ellipse.

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

Zeichnet eine Ellipse, die durch ein umgebendes Rechteck definiert wird, das durch Koordinaten für die obere linke Ecke des Rechtecks, einer Höhe und einer Breite angegeben wird.

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)

Parameter

pen

Pen

Pen, die die Farbe, Breite und Formatvorlage der Ellipse bestimmt.

x

Int32

Die x-Koordinate der oberen linken Ecke des umgebenden Rechtecks, das die Auslassungspunkte definiert.

y

Int32

Die y-Koordinate der oberen linken Ecke des umgebenden Rechtecks, das die Auslassungspunkte definiert.

width

Int32

Breite des umgebenden Rechtecks, das die Auslassungspunkte definiert.

height

Int32

Höhe des umgebenden Rechtecks, das die Auslassungspunkte definiert.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt einen schwarzen Stift.

• Erstellt die Position und Größe eines Rechtecks, um eine Ellipse zu binden.

• Zeichnet die Auslassungspunkte auf den Bildschirm.

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

Hinweise

Diese Methode zeichnet eine Ellipse, die durch das umgebende Rechteck definiert wird, das durch die parameter x, y, widthund height beschrieben wird.

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

Zeichnet eine Ellipse, die durch ein begrenzungsfähiges Rechteck definiert wird, das durch ein Koordinatenpaar, eine Höhe und eine Breite angegeben wird.

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)

Parameter

pen

Pen

Pen, die die Farbe, Breite und Formatvorlage der Ellipse bestimmt.

x

Single

Die x-Koordinate der oberen linken Ecke des umgebenden Rechtecks, das die Auslassungspunkte definiert.

y

Single

Die y-Koordinate der oberen linken Ecke des umgebenden Rechtecks, das die Auslassungspunkte definiert.

width

Single

Breite des umgebenden Rechtecks, das die Auslassungspunkte definiert.

height

Single

Höhe des umgebenden Rechtecks, das die Auslassungspunkte definiert.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt einen schwarzen Stift.

• Erstellt die Position und Größe eines Rechtecks, um eine Ellipse zu binden.

• Zeichnet die Auslassungspunkte auf den Bildschirm.

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

Hinweise

Diese Methode zeichnet eine Ellipse, die durch das umgebende Rechteck definiert wird, das durch die parameter x, y, widthund height beschrieben wird.

DrawEllipse(Pen, RectangleF)

Zeichnet eine durch eine begrenzungsgebundene RectangleFdefinierte Ellipse.

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)

Parameter

pen

Pen

Pen, die die Farbe, Breite und Formatvorlage der Ellipse bestimmt.

rect

RectangleF

RectangleF Struktur, die die Grenzen der Auslassungspunkte definiert.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt einen schwarzen Stift.

• Erstellt ein Rechteck, um eine Ellipse zu binden.

• Zeichnet die Auslassungspunkte auf den Bildschirm.

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

Hinweise

Diese Methode zeichnet eine Ellipse, die durch das durch den parameter rect angegebene Begrenzungsrechteck definiert wird.

DrawEllipse(Pen, Rectangle)

Zeichnet eine durch eine umgebende Rectangle Struktur angegebene Ellipse.

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)

Parameter

pen

Pen

Pen, die die Farbe, Breite und Formatvorlage der Ellipse bestimmt.

rect

Rectangle

Rectangle Struktur, die die Grenzen der Auslassungspunkte definiert.

Ausnahmen

ArgumentNullException

pen ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt einen schwarzen Stift.

• Erstellt ein Rechteck, um eine Ellipse zu binden.

• Zeichnet die Auslassungspunkte auf den Bildschirm.

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

Hinweise

Diese Methode zeichnet eine Ellipse, die durch das durch den parameter rect angegebene Begrenzungsrechteck definiert wird.