Graphics.DrawEllipse Método

Definición

Dibuja una elipse definida por un rectángulo delimitador especificado por un par de coordenadas, un valor de alto y un valor de ancho.Draws an ellipse defined by a bounding rectangle specified by a pair of coordinates, a height, and a width.

Sobrecargas

DrawEllipse(Pen, Rectangle)

Dibuja una elipse especificada por una estructura Rectangle de delimitación.Draws an ellipse specified by a bounding Rectangle structure.

DrawEllipse(Pen, RectangleF)

Dibuja una elipse definida por una estructura RectangleF de delimitación.Draws an ellipse defined by a bounding RectangleF.

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

Dibuja una elipse definida por un rectángulo delimitador que se especifica mediante las coordenadas de la esquina superior izquierda, un valor de alto y un valor de ancho.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)

Dibuja una elipse definida por un rectángulo delimitador especificado por un par de coordenadas, un valor de alto y un valor de ancho.Draws an ellipse defined by a bounding rectangle specified by a pair of coordinates, a height, and a width.

DrawEllipse(Pen, Rectangle)

Dibuja una elipse especificada por una estructura Rectangle de delimitación.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

Parámetros

pen
Pen

Pen que determina el color, ancho y estilo de la elipse.Pen that determines the color, width, and style of the ellipse.

rect
Rectangle

Estructura Rectangle que define los límites de la elipse.Rectangle structure that defines the boundaries of the ellipse.

Excepciones

pen es null.pen is null.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un lápiz negro.Creates a black pen.

  • Crea un rectángulo para enlazar una elipse.Creates a rectangle to bound an ellipse.

  • Dibuja la elipse en la pantalla.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

Comentarios

Este método dibuja una elipse definida por el rectángulo delimitador especificado por el rect parámetro.This method draws an ellipse that is defined by the bounding rectangle specified by the rect parameter.

DrawEllipse(Pen, RectangleF)

Dibuja una elipse definida por una estructura RectangleF de delimitación.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

Parámetros

pen
Pen

Pen que determina el color, ancho y estilo de la elipse.Pen that determines the color, width, and style of the ellipse.

rect
RectangleF

Estructura RectangleF que define los límites de la elipse.RectangleF structure that defines the boundaries of the ellipse.

Excepciones

pen es null.pen is null.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un lápiz negro.Creates a black pen.

  • Crea un rectángulo para enlazar una elipse.Creates a rectangle to bound an ellipse.

  • Dibuja la elipse en la pantalla.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

Comentarios

Este método dibuja una elipse definida por el rectángulo delimitador especificado por el rect parámetro.This method draws an ellipse that is defined by the bounding rectangle specified by the rect parameter.

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

Dibuja una elipse definida por un rectángulo delimitador que se especifica mediante las coordenadas de la esquina superior izquierda, un valor de alto y un valor de ancho.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

Parámetros

pen
Pen

Pen que determina el color, ancho y estilo de la elipse.Pen that determines the color, width, and style of the ellipse.

x
Int32

Coordenada x de la esquina superior izquierda del rectángulo delimitador que define la elipse.The x-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse.

y
Int32

Coordenada y de la esquina superior izquierda del rectángulo delimitador que define la elipse.The y-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse.

width
Int32

Ancho del rectángulo delimitador que define la elipse.Width of the bounding rectangle that defines the ellipse.

height
Int32

Alto del rectángulo delimitador que define la elipse.Height of the bounding rectangle that defines the ellipse.

Excepciones

pen es null.pen is null.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un lápiz negro.Creates a black pen.

  • Crea la posición y el tamaño de un rectángulo para enlazar una elipse.Creates the position and size of a rectangle to bound an ellipse.

  • Dibuja la elipse en la pantalla.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

Comentarios

Este método dibuja una elipse definida por el rectángulo delimitador descrito por los xparámetros y, width, y 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)

Dibuja una elipse definida por un rectángulo delimitador especificado por un par de coordenadas, un valor de alto y un valor de ancho.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

Parámetros

pen
Pen

Pen que determina el color, ancho y estilo de la elipse.Pen that determines the color, width, and style of the ellipse.

x
Single

Coordenada x de la esquina superior izquierda del rectángulo delimitador que define la elipse.The x-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse.

y
Single

Coordenada y de la esquina superior izquierda del rectángulo delimitador que define la elipse.The y-coordinate of the upper-left corner of the bounding rectangle that defines the ellipse.

width
Single

Ancho del rectángulo delimitador que define la elipse.Width of the bounding rectangle that defines the ellipse.

height
Single

Alto del rectángulo delimitador que define la elipse.Height of the bounding rectangle that defines the ellipse.

Excepciones

pen es null.pen is null.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea un lápiz negro.Creates a black pen.

  • Crea la posición y el tamaño de un rectángulo para enlazar una elipse.Creates the position and size of a rectangle to bound an ellipse.

  • Dibuja la elipse en la pantalla.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

Comentarios

Este método dibuja una elipse definida por el rectángulo delimitador descrito por los xparámetros y, width, y height .This method draws an ellipse that is defined by the bounding rectangle described by the x, y, width, and height parameters.

Se aplica a