Graphics.FillRectangles Method (Brush, Rectangle())

 

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

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

Public Sub FillRectangles (
	brush As Brush,
	rects As Rectangle()
)

Parameters

brush
Type: System.Drawing.Brush

Brush that determines the characteristics of the fill.

rects
Type: System.Drawing.Rectangle()

Array of Rectangle 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 Sub FillRectanglesRectangle(ByVal e As PaintEventArgs)

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

    ' Create array of rectangles.
    Dim rects As Rectangle() = {New Rectangle(0, 0, 100, 200), _
    New Rectangle(100, 200, 250, 50), _
    New Rectangle(300, 0, 50, 100)}

    ' Fill rectangles to screen.
    e.Graphics.FillRectangles(blueBrush, rects)
End Sub

.NET Framework
Available since 1.1
Return to top
Show: