Graphics::FillRectangles Method (Brush^, 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.

Fills the interiors of a series of rectangles specified by RectangleF structures.

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

public:
void FillRectangles(
	Brush^ brush,
	array<RectangleF>^ rects
)

Parameters

brush
Type: System.Drawing::Brush^

Brush that determines the characteristics of the fill.

rects
Type: array<System.Drawing::RectangleF>^

Array of RectangleF structures that represent the rectangles to fill.

Exception Condition
ArgumentNullException

brush 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 action:

  • Creates a solid blue brush.

  • Creates an array of three rectangles.

  • Fills the three rectangular areas on the screen.

public:
   void FillRectanglesRectangleF( PaintEventArgs^ e )
   {
      // Create solid brush.
      SolidBrush^ blueBrush = gcnew SolidBrush( Color::Blue );

      // 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)};

      // Fill rectangles to screen.
      e->Graphics->FillRectangles( blueBrush, rects );
   }

.NET Framework
Available since 1.1
Return to top
Show: