Graphics.DrawRectangles Method (Pen, Rectangle())

 
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 Rectangle structures.

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

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

Parameters

pen
Type: System.Drawing.Pen

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

rects
Type: System.Drawing.Rectangle()

Array of Rectangle 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.

Public Sub DrawRectanglesRectangle(ByVal e As PaintEventArgs)

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

    ' Create array of rectangles.
    Dim rects As Rectangle() = {New Rectangle(0, 0, 100, 200), _
    New Rectangle(100, 200, 250, 50), _
    New Rectangle(300, 0, 50, 100)}

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

.NET Framework
Available since 1.1
Return to top
Show: