Graphics.FillRegion(Brush, Region) Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Package:

System.Drawing.Common v9.0.0-rc.2.24474.1

Source:

Graphics.cs

Fills the interior of a Region.

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

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

member this.FillRegion : System.Drawing.Brush * System.Drawing.Region -> unit

Public Sub FillRegion (brush As Brush, region As 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.

public:
   void FillRegionRectangle( PaintEventArgs^ e )
   {
      // Create solid brush.
      SolidBrush^ blueBrush = gcnew SolidBrush( Color::Blue );

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

      // Create region for fill.
      System::Drawing::Region^ fillRegion = gcnew System::Drawing::Region( fillRect );

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

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

Private Sub FillRegionRectangle(ByVal e As PaintEventArgs)

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

    ' Create rectangle for region.
    Dim fillRect As New Rectangle(100, 100, 200, 200)

    ' Create region for fill.
    Dim fillRegion As New [Region](fillRect)

    ' Fill region to screen.
    e.Graphics.FillRegion(blueBrush, fillRegion)
End Sub

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.