Export (0) Print
Expand All

Graphics.DrawRectangle Method (Pen, Rectangle)

Draws a rectangle specified by a Rectangle structure.

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

public void DrawRectangle(
	Pen pen,
	Rectangle rect
)

Parameters

pen
Type: System.Drawing.Pen

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

rect
Type: System.Drawing.Rectangle

A Rectangle structure that represents the rectangle to draw.

ExceptionCondition
ArgumentNullException

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 PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

  • Creates a black pen.

  • Creates a rectangle.

  • Draws the rectangle to the screen.

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft