Graphics.DrawRectangles Method (Pen, RectangleF[])
Draws a series of rectangles specified by RectangleF structures.
Namespace: System.Drawing
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 PaintEventArgs e, 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 void DrawRectanglesRectangleF(PaintEventArgs e) { // Create pen. Pen blackPen = new Pen(Color.Black, 3); // Create array of rectangles. RectangleF[] rects = { 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); }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
