Graphics.FillRectangles Method (Brush, RectangleF[])

 

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,
	RectangleF[] rects
)

Parameters

brush
Type: System.Drawing.Brush

Brush that determines the characteristics of the fill.

rects
Type: 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.

private void FillRectanglesRectangleF(PaintEventArgs e)
{

    // Create solid brush.
    SolidBrush blueBrush = new SolidBrush(Color.Blue);

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

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

.NET Framework
Available since 1.1
Return to top
Show: