Graphics::DrawRectangles Method (Pen^, array<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:
array<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: void DrawRectanglesRectangle( PaintEventArgs^ e ) { // Create pen. Pen^ blackPen = gcnew Pen( Color::Black,3.0f ); // Create array of rectangles. array<Rectangle>^ rects = {Rectangle(0,0,100,200),Rectangle(100,200,250,50),Rectangle(300,0,50,100)}; // Draw rectangles to screen. e->Graphics->DrawRectangles( blackPen, rects ); }
.NET Framework
Available since 1.1
Available since 1.1
Show: