Graphics.DrawRectangles Method (Pen, RectangleF[])

 
System_CAPS_noteNote

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

Draws a series of rectangles specified by RectangleF structures.

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

member DrawRectangles : 
        pen:Pen *
        rects:RectangleF[] -> unit

Parameters

pen
Type: System.Drawing.Pen

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

rects
Type: System.Drawing.RectangleF[]

Array of RectangleF structures that represent the rectangles to draw.

Exception Condition
ArgumentNullException

pen is null.

-or-

rects is null.

ArgumentException

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.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: