Graphics.FillPath(Brush, GraphicsPath) Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Source:

Graphics.cs

Fills the interior of a GraphicsPath.

public:
 void FillPath(System::Drawing::Brush ^ brush, System::Drawing::Drawing2D::GraphicsPath ^ path);

public void FillPath (System.Drawing.Brush brush, System.Drawing.Drawing2D.GraphicsPath path);

member this.FillPath : System.Drawing.Brush * System.Drawing.Drawing2D.GraphicsPath -> unit

Public Sub FillPath (brush As Brush, path As GraphicsPath)

Parameters

brush

Brush

Brush that determines the characteristics of the fill.

path

GraphicsPath

GraphicsPath that represents the path to fill.

Exceptions

ArgumentNullException

brush is null.

-or-

path 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 actions:

• Creates a solid red brush.

• Creates a graphics path object.

• Adds an ellipse to the graphics path.

• Fills the path on the screen.

public:
   void FillPathEllipse( PaintEventArgs^ e )
   {
      // Create solid brush.
      SolidBrush^ redBrush = gcnew SolidBrush( Color::Red );

      // Create graphics path object and add ellipse.
      GraphicsPath^ graphPath = gcnew GraphicsPath;
      graphPath->AddEllipse( 0, 0, 200, 100 );

      // Fill graphics path to screen.
      e->Graphics->FillPath( redBrush, graphPath );
   }

public void FillPathEllipse(PaintEventArgs e)
{
             
    // Create solid brush.
    SolidBrush redBrush = new SolidBrush(Color.Red);
             
    // Create graphics path object and add ellipse.
    GraphicsPath graphPath = new GraphicsPath();
    graphPath.AddEllipse(0, 0, 200, 100);
             
    // Fill graphics path to screen.
    e.Graphics.FillPath(redBrush, graphPath);
}

Public Sub FillPathEllipse(ByVal e As PaintEventArgs)

    ' Create solid brush.
    Dim redBrush As New SolidBrush(Color.Red)

    ' Create graphics path object and add ellipse.
    Dim graphPath As New GraphicsPath
    graphPath.AddEllipse(0, 0, 200, 100)

    ' Fill graphics path to screen.
    e.Graphics.FillPath(redBrush, graphPath)
End Sub

Remarks

A GraphicsPath consists of a series of line and curve segments. If the path represented by the path parameter is not closed, an additional segment is added from the last point to the first point to close the path.