Graphics.DrawRectangles Method (Pen, Rectangle())
.NET Framework (current version)
Draws a series of rectangles specified by Rectangle structures.
Assembly: System.Drawing (in System.Drawing.dll)
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
Available since 1.1
Show: