Graphics.DrawRectangle Graphics.DrawRectangle Graphics.DrawRectangle Method

Definición

Dibuja un rectángulo especificado por un par de coordenadas, un valor de ancho y un valor de alto.Draws a rectangle specified by a coordinate pair, a width, and a height.

Sobrecargas

DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle)

Dibuja un rectángulo especificado por una estructura Rectangle.Draws a rectangle specified by a Rectangle structure.

DrawRectangle(Pen, Int32, Int32, Int32, Int32) DrawRectangle(Pen, Int32, Int32, Int32, Int32) DrawRectangle(Pen, Int32, Int32, Int32, Int32)

Dibuja un rectángulo especificado por un par de coordenadas, un valor de ancho y un valor de alto.Draws a rectangle specified by a coordinate pair, a width, and a height.

DrawRectangle(Pen, Single, Single, Single, Single) DrawRectangle(Pen, Single, Single, Single, Single) DrawRectangle(Pen, Single, Single, Single, Single)

Dibuja un rectángulo especificado por un par de coordenadas, un valor de ancho y un valor de alto.Draws a rectangle specified by a coordinate pair, a width, and a height.

DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle)

Dibuja un rectángulo especificado por una estructura Rectangle.Draws a rectangle specified by a Rectangle structure.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, System::Drawing::Rectangle rect);
public void DrawRectangle (System.Drawing.Pen pen, System.Drawing.Rectangle rect);
member this.DrawRectangle : System.Drawing.Pen * System.Drawing.Rectangle -> unit

Parámetros

pen
Pen Pen Pen

Pen que determina el color, ancho y estilo del rectángulo.A Pen that determines the color, width, and style of the rectangle.

rect
Rectangle Rectangle Rectangle

Estructura Rectangle que representa el rectángulo que se va a dibujar.A Rectangle structure that represents the rectangle to draw.

Excepciones

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.Creates a rectangle.

  • Dibuja el rectángulo en la pantalla.Draws the rectangle to the screen.

public:
   void DrawRectangleRectangle( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create rectangle.
      Rectangle rect = Rectangle(0,0,200,200);

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, rect );
   }
public void DrawRectangleRectangle(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create rectangle.
    Rectangle rect = new Rectangle(0, 0, 200, 200);
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, rect);
}
Public Sub DrawRectangleRectangle(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create rectangle.
    Dim rect As New Rectangle(0, 0, 200, 200)

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, rect)
End Sub

Comentarios

Para obtener información sobre cómo dibujar un RectangleF, vea DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

DrawRectangle(Pen, Int32, Int32, Int32, Int32) DrawRectangle(Pen, Int32, Int32, Int32, Int32) DrawRectangle(Pen, Int32, Int32, Int32, Int32)

Dibuja un rectángulo especificado por un par de coordenadas, un valor de ancho y un valor de alto.Draws a rectangle specified by a coordinate pair, a width, and a height.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, int x, int y, int width, int height);
public void DrawRectangle (System.Drawing.Pen pen, int x, int y, int width, int height);
member this.DrawRectangle : System.Drawing.Pen * int * int * int * int -> unit

Parámetros

pen
Pen Pen Pen

Pen que determina el color, ancho y estilo del rectángulo.Pen that determines the color, width, and style of the rectangle.

x
Int32 Int32 Int32

Coordenada x de la esquina superior izquierda del rectángulo que se va a dibujar.The x-coordinate of the upper-left corner of the rectangle to draw.

y
Int32 Int32 Int32

Coordenada y de la esquina superior izquierda del rectángulo que se va a dibujar.The y-coordinate of the upper-left corner of the rectangle to draw.

width
Int32 Int32 Int32

Ancho del rectángulo que se va a dibujar.Width of the rectangle to draw.

height
Int32 Int32 Int32

Alto del rectángulo que se va a dibujar.Height of the rectangle to draw.

Excepciones

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.Creates the position and size of a rectangle.

  • Dibuja el rectángulo en la pantalla.Draws the rectangle to the screen.

public:
   void DrawRectangleInt( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create location and size of rectangle.
      int x = 0;
      int y = 0;
      int width = 200;
      int height = 200;

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );
   }
public void DrawRectangleInt(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of rectangle.
    int x = 0;
    int y = 0;
    int width = 200;
    int height = 200;
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
}
Public Sub DrawRectangleInt(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create location and size of rectangle.
    Dim x As Integer = 0
    Dim y As Integer = 0
    Dim width As Integer = 200
    Dim height As Integer = 200

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)
End Sub

Comentarios

Para obtener información sobre cómo dibujar un RectangleF, vea DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

DrawRectangle(Pen, Single, Single, Single, Single) DrawRectangle(Pen, Single, Single, Single, Single) DrawRectangle(Pen, Single, Single, Single, Single)

Dibuja un rectángulo especificado por un par de coordenadas, un valor de ancho y un valor de alto.Draws a rectangle specified by a coordinate pair, a width, and a height.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, float x, float y, float width, float height);
public void DrawRectangle (System.Drawing.Pen pen, float x, float y, float width, float height);
member this.DrawRectangle : System.Drawing.Pen * single * single * single * single -> unit

Parámetros

pen
Pen Pen Pen

Pen que determina el color, ancho y estilo del rectángulo.A Pen that determines the color, width, and style of the rectangle.

x
Single Single Single

Coordenada x de la esquina superior izquierda del rectángulo que se va a dibujar.The x-coordinate of the upper-left corner of the rectangle to draw.

y
Single Single Single

Coordenada y de la esquina superior izquierda del rectángulo que se va a dibujar.The y-coordinate of the upper-left corner of the rectangle to draw.

width
Single Single Single

Ancho del rectángulo que se va a dibujar.The width of the rectangle to draw.

height
Single Single Single

Alto del rectángulo que se va a dibujar.The height of the rectangle to draw.

Excepciones

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.Creates the position and size of a rectangle.

  • Dibuja el rectángulo en la pantalla.Draws the rectangle to the screen.

public:
   void DrawRectangleFloat( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create location and size of rectangle.
      float x = 0.0F;
      float y = 0.0F;
      float width = 200.0F;
      float height = 200.0F;

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );
   }
public void DrawRectangleFloat(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of rectangle.
    float x = 0.0F;
    float y = 0.0F;
    float width = 200.0F;
    float height = 200.0F;
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
}
Public Sub DrawRectangleFloat(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create location and size of rectangle.
    Dim x As Single = 0.0F
    Dim y As Single = 0.0F
    Dim width As Single = 200.0F
    Dim height As Single = 200.0F

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)
End Sub

Comentarios

Para obtener información sobre cómo dibujar un RectangleF, vea DrawRectangles(Pen, RectangleF[]).For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

Se aplica a