Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
FillRectangles Method (Brush, RectangleF[])
Collapse the table of content
Expand the table of content

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)

'Declaration
Public Sub FillRectangles ( _
	brush As Brush, _
	rects As RectangleF() _
)

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.

ExceptionCondition
ArgumentNullException

brush is Nothing.

-or-

rects is Nothing.

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 Sub FillRectanglesRectangleF(ByVal e As PaintEventArgs)

    ' Create solid brush. 
    Dim blueBrush As New SolidBrush(Color.Blue)

    ' Create array of rectangles. 
    Dim rects As RectangleF() = {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)
End Sub

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft