Graphics::DrawRectangles Method (Pen^, array<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:
array<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: void DrawRectanglesRectangleF( PaintEventArgs^ e ) { // Create pen. Pen^ blackPen = gcnew Pen( Color::Black,3.0f ); // Create array of rectangles. array<RectangleF>^ rects = {RectangleF(0.0F,0.0F,100.0F,200.0F),RectangleF(100.0F,200.0F,250.0F,50.0F),RectangleF(300.0F,0.0F,50.0F,100.0F)}; // Draw rectangles to screen. e->Graphics->DrawRectangles( blackPen, rects ); }
.NET Framework
Available since 1.1
Available since 1.1
Show: