Graphics.DrawRectangle Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Dibuja un rectángulo especificado por un par de coordenadas, un ancho y un alto.

Sobrecargas

DrawRectangle(Pen, Int32, Int32, Int32, Int32)	Dibuja un rectángulo especificado por un par de coordenadas, un ancho y un alto.
DrawRectangle(Pen, Single, Single, Single, Single)	Dibuja un rectángulo especificado por un par de coordenadas, un ancho y un alto.
DrawRectangle(Pen, RectangleF)	Dibuja el contorno del rectángulo especificado.
DrawRectangle(Pen, Rectangle)	Dibuja un rectángulo especificado por una estructura Rectangle.

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

Dibuja un rectángulo especificado por un par de coordenadas, un ancho y un alto.

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

Public Sub DrawRectangle (pen As Pen, x As Integer, y As Integer, width As Integer, height As Integer)

Parámetros

pen

Pen

Pen que determina el color, el ancho y el estilo del rectángulo.

x

Int32

Coordenada x de la esquina superior izquierda del rectángulo que se va a dibujar.

y

Int32

Coordenada y de la esquina superior izquierda del rectángulo que se va a dibujar.

width

Int32

Ancho del rectángulo que se va a dibujar.

height

Int32

Alto del rectángulo que se va a dibujar.

Excepciones

ArgumentNullException

pen es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

• Crea un lápiz negro.

• Crea la posición y el tamaño de un rectángulo.

• Dibuja el rectángulo en la pantalla.

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[]).

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

Dibuja un rectángulo especificado por un par de coordenadas, un ancho y un alto.

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

Public Sub DrawRectangle (pen As Pen, x As Single, y As Single, width As Single, height As Single)

Parámetros

pen

Pen

Un Pen que determina el color, el ancho y el estilo del rectángulo.

x

Single

Coordenada x de la esquina superior izquierda del rectángulo que se va a dibujar.

y

Single

Coordenada y de la esquina superior izquierda del rectángulo que se va a dibujar.

width

Single

Ancho del rectángulo que se va a dibujar.

height

Single

Alto del rectángulo que se va a dibujar.

Excepciones

ArgumentNullException

pen es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

• Crea un lápiz negro.

• Crea la posición y el tamaño de un rectángulo.

• Dibuja el rectángulo en la pantalla.

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[]).

DrawRectangle(Pen, RectangleF)

Dibuja el contorno del rectángulo especificado.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, System::Drawing::RectangleF rect);

public void DrawRectangle (System.Drawing.Pen pen, System.Drawing.RectangleF rect);

member this.DrawRectangle : System.Drawing.Pen * System.Drawing.RectangleF -> unit

Public Sub DrawRectangle (pen As Pen, rect As RectangleF)

Parámetros

pen

Pen

Lápiz que determina el color, el ancho y el estilo del rectángulo.

rect

RectangleF

Rectángulo que se va a dibujar.

DrawRectangle(Pen, Rectangle)

Dibuja un rectángulo especificado por una estructura Rectangle.

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

Public Sub DrawRectangle (pen As Pen, rect As Rectangle)

Parámetros

pen

Pen

Un Pen que determina el color, el ancho y el estilo del rectángulo.

rect

Rectangle

Estructura Rectangle que representa el rectángulo que se va a dibujar.

Excepciones

ArgumentNullException

pen es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

• Crea un lápiz negro.

• Crea un rectángulo.

• Dibuja el rectángulo en la pantalla.

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[]).