Graphics.FillPolygon Method (Brush, Point[], FillMode)

Fills the interior of a polygon defined by an array of points specified by Point structures using the specified fill mode.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

public:
void FillPolygon (
	Brush^ brush, 
	array<Point>^ points, 
	FillMode fillMode
)
public void FillPolygon (
	Brush brush, 
	Point[] points, 
	FillMode fillMode
)
public function FillPolygon (
	brush : Brush, 
	points : Point[], 
	fillMode : FillMode
)
Not applicable.

Parameters

brush

Brush that determines the characteristics of the fill.

points

Array of Point structures that represent the vertices of the polygon to fill.

fillMode

Member of the FillMode enumeration that determines the style of the fill.

Exception typeCondition

ArgumentNullException

brush is a null reference (Nothing in Visual Basic).

-or-

points is a null reference (Nothing in Visual Basic).

Every two consecutive points in the array specify a side of the polygon. In addition, if the last point and the first point do not coincide, they specify the closing side of the polygon.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. The code performs the following actions:

  • Creates a solid blue brush.

  • Creates an array of seven points to define a polygon.

  • Sets the fill mode to Winding.

  • Fills the polygonal area on the screen.

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

      // Create points that define polygon.
      Point point1 = Point(50,50);
      Point point2 = Point(100,25);
      Point point3 = Point(200,5);
      Point point4 = Point(250,50);
      Point point5 = Point(300,100);
      Point point6 = Point(350,200);
      Point point7 = Point(250,250);
      array<Point>^ curvePoints = {point1,point2,point3,point4,point5,point6,point7};

      // Define fill mode.
      FillMode newFillMode = FillMode::Winding;

      // Draw polygon to screen.
      e->Graphics->FillPolygon( blueBrush, curvePoints, newFillMode );
   }

public void FillPolygonPointFillMode(PaintEventArgs e) 
{
    // Create solid brush.
    SolidBrush blueBrush =  new SolidBrush(Color.get_Blue());

    // Create points that define polygon.
    Point point1 =  new Point(50, 50);
    Point point2 =  new Point(100, 25);
    Point point3 =  new Point(200, 5);
    Point point4 =  new Point(250, 50);
    Point point5 =  new Point(300, 100);
    Point point6 =  new Point(350, 200);
    Point point7 =  new Point(250, 250);
    Point curvePoints[] =  {point1, point2, point3, point4, point5, point6,
                            point7};

    // Define fill mode.
    FillMode newFillMode = FillMode.Winding;

    // Draw polygon to screen.
    e.get_Graphics().FillPolygon(blueBrush, curvePoints, newFillMode);
} //FillPolygonPointFillMode

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show: