Graphics.FillRectangles Method

Definition

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

Overloads

FillRectangles(Brush, ReadOnlySpan<RectangleF>)
FillRectangles(Brush, ReadOnlySpan<Rectangle>)
FillRectangles(Brush, RectangleF[])

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

FillRectangles(Brush, Rectangle[])

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

FillRectangles(Brush, ReadOnlySpan<RectangleF>)

public:
 void FillRectangles(System::Drawing::Brush ^ brush, ReadOnlySpan<System::Drawing::RectangleF> rects);
public void FillRectangles (System.Drawing.Brush brush, ReadOnlySpan<System.Drawing.RectangleF> rects);
member this.FillRectangles : System.Drawing.Brush * ReadOnlySpan<System.Drawing.RectangleF> -> unit
Public Sub FillRectangles (brush As Brush, rects As ReadOnlySpan(Of RectangleF))

Parameters

brush
Brush

Applies to

FillRectangles(Brush, ReadOnlySpan<Rectangle>)

public:
 void FillRectangles(System::Drawing::Brush ^ brush, ReadOnlySpan<System::Drawing::Rectangle> rects);
public void FillRectangles (System.Drawing.Brush brush, ReadOnlySpan<System.Drawing.Rectangle> rects);
member this.FillRectangles : System.Drawing.Brush * ReadOnlySpan<System.Drawing.Rectangle> -> unit
Public Sub FillRectangles (brush As Brush, rects As ReadOnlySpan(Of Rectangle))

Parameters

brush
Brush

Applies to

FillRectangles(Brush, RectangleF[])

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

public:
 void FillRectangles(System::Drawing::Brush ^ brush, cli::array <System::Drawing::RectangleF> ^ rects);
public:
 void FillRectangles(System::Drawing::Brush ^ brush, ... cli::array <System::Drawing::RectangleF> ^ rects);
public void FillRectangles (System.Drawing.Brush brush, System.Drawing.RectangleF[] rects);
public void FillRectangles (System.Drawing.Brush brush, params System.Drawing.RectangleF[] rects);
member this.FillRectangles : System.Drawing.Brush * System.Drawing.RectangleF[] -> unit
Public Sub FillRectangles (brush As Brush, rects As RectangleF())
Public Sub FillRectangles (brush As Brush, ParamArray rects As RectangleF())

Parameters

brush
Brush

Brush that determines the characteristics of the fill.

rects
RectangleF[]

Array of RectangleF structures that represent the rectangles to fill.

Exceptions

brush is null.

-or-

rects is null.

Rects is a zero-length array.

Examples

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

Applies to

FillRectangles(Brush, Rectangle[])

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

public:
 void FillRectangles(System::Drawing::Brush ^ brush, cli::array <System::Drawing::Rectangle> ^ rects);
public:
 void FillRectangles(System::Drawing::Brush ^ brush, ... cli::array <System::Drawing::Rectangle> ^ rects);
public void FillRectangles (System.Drawing.Brush brush, System.Drawing.Rectangle[] rects);
public void FillRectangles (System.Drawing.Brush brush, params System.Drawing.Rectangle[] rects);
member this.FillRectangles : System.Drawing.Brush * System.Drawing.Rectangle[] -> unit
Public Sub FillRectangles (brush As Brush, rects As Rectangle())
Public Sub FillRectangles (brush As Brush, ParamArray rects As Rectangle())

Parameters

brush
Brush

Brush that determines the characteristics of the fill.

rects
Rectangle[]

Array of Rectangle structures that represent the rectangles to fill.

Exceptions

brush is null.

-or-

rects is null.

rects is a zero-length array.

Examples

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 FillRectanglesRectangle( PaintEventArgs^ e )
   {
      // Create solid brush.
      SolidBrush^ blueBrush = gcnew SolidBrush( Color::Blue );

      // Create array of rectangles.
      array<Rectangle>^ rects = {Rectangle(0,0,100,200),Rectangle(100,200,250,50),Rectangle(300,0,50,100)};

      // Fill rectangles to screen.
      e->Graphics->FillRectangles( blueBrush, rects );
   }
private void FillRectanglesRectangle(PaintEventArgs e)
{

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

    // Create array of rectangles.
    Rectangle[] rects = { 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);
}
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

Applies to