Graphics::DrawRectangles Method (Pen^, array<RectangleF>^)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Draws a series of rectangles specified by RectangleF structures.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public:
void DrawRectangles(
	Pen^ pen,
	array<RectangleF>^ rects
)

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
Return to top
Show: