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