Graphics::FillRectangles Method (Brush^, array<Rectangle>^)
.NET Framework (current version)
Fills the interiors of a series of rectangles specified by Rectangle structures.
Assembly: System.Drawing (in System.Drawing.dll)
Parameters
- brush
-
Type:
System.Drawing::Brush^
Brush that determines the characteristics of the fill.
- rects
-
Type:
array<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.
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 ); }
.NET Framework
Available since 1.1
Available since 1.1
Show: