Graphics.DrawRectangles Method (Pen, RectangleF())


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

Draws a series of rectangles specified by RectangleF structures.

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

Public Sub DrawRectangles (
	pen As Pen,
	rects As RectangleF()


Type: System.Drawing.Pen

Pen that determines the color, width, and style of the outlines of the rectangles.

Type: System.Drawing.RectangleF()

Array of RectangleF structures that represent the rectangles to draw.

Exception Condition

pen is null.


rects is null.


rects is a zero-length array.

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 an array of three rectangles.

  • Draws the rectangles to the screen.

Public Sub DrawRectanglesRectangleF(ByVal e As PaintEventArgs)

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

    ' Create array of rectangles.
    Dim rects As RectangleF() = {New RectangleF(0.0F, 0.0F, 100.0F, 200.0F), _
    New RectangleF(100.0F, 200.0F, 250.0F, 50.0F), _
    New RectangleF(300.0F, 0.0F, 50.0F, 100.0F)}

    ' Draw rectangles to screen.
    e.Graphics.DrawRectangles(blackPen, rects)
End Sub

.NET Framework
Available since 1.1
Return to top