Graphics.DrawRectangle Method (Pen, Single, Single, Single, Single)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Draws a rectangle specified by a coordinate pair, a width, and a height.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public void DrawRectangle(
	Pen pen,
	float x,
	float y,
	float width,
	float height


Type: System.Drawing.Pen

A Pen that determines the color, width, and style of the rectangle.

Type: System.Single

The x-coordinate of the upper-left corner of the rectangle to draw.

Type: System.Single

The y-coordinate of the upper-left corner of the rectangle to draw.

Type: System.Single

The width of the rectangle to draw.

Type: System.Single

The height of the rectangle to draw.

Exception Condition

pen is null.

For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

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.

  • Draws the rectangle to the screen.

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);

.NET Framework
Available since 1.1
Return to top