Graphics.FillRegion(Brush, Region) Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Source:

Graphics.cs

Fills the interior of a Region.

C#

public void FillRegion(System.Drawing.Brush brush, System.Drawing.Region region);

Parameters

brush

Brush

Brush that determines the characteristics of the fill.

region

Region

Region that represents the area to fill.

Exceptions

ArgumentNullException

brush is null.

-or-

region is null.

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 a rectangle.

• Creates a rectangular region.

• Fills the rectangular region on the screen.

C#

private void FillRegionRectangle(PaintEventArgs e)
{

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

    // Create rectangle for region.
    Rectangle fillRect = new Rectangle(100, 100, 200, 200);

    // Create region for fill.
    Region fillRegion = new Region(fillRect);

    // Fill region to screen.
    e.Graphics.FillRegion(blueBrush, fillRegion);
}

Remarks

A Region is composed of rectangles and paths. If the region is not closed, an additional segment is added from the last point to the first point to close it.

Applies to