Graphics.FillRectangle Method

Reference

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Package:: System.Drawing.Common v9.0.2

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height.

Overloads

FillRectangle(Brush, Rectangle)	Fills the interior of a rectangle specified by a Rectangle structure.
FillRectangle(Brush, RectangleF)	Fills the interior of a rectangle specified by a RectangleF structure.
FillRectangle(Brush, Int32, Int32, Int32, Int32)	Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height.
FillRectangle(Brush, Single, Single, Single, Single)	Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height.

FillRectangle(Brush, Rectangle)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Fills the interior of a rectangle specified by a Rectangle structure.

public:
 void FillRectangle(System::Drawing::Brush ^ brush, System::Drawing::Rectangle rect);

public void FillRectangle(System.Drawing.Brush brush, System.Drawing.Rectangle rect);

member this.FillRectangle : System.Drawing.Brush * System.Drawing.Rectangle -> unit

Public Sub FillRectangle (brush As Brush, rect As Rectangle)

Parameters

brush: Brush

Brush that determines the characteristics of the fill.

rect: Rectangle

Rectangle structure that represents the rectangle to fill.

Exceptions

ArgumentNullException

brush 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.
Fills the rectangular area on the screen.

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

      // Create rectangle.
      Rectangle rect = Rectangle(0,0,200,200);

      // Fill rectangle to screen.
      e->Graphics->FillRectangle( blueBrush, rect );
   }

private void FillRectangleRectangle(PaintEventArgs e)
{

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

    // Create rectangle.
    Rectangle rect = new Rectangle(0, 0, 200, 200);

    // Fill rectangle to screen.
    e.Graphics.FillRectangle(blueBrush, rect);
}

Private Sub FillRectangleRectangle(ByVal e As PaintEventArgs)

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

    ' Create rectangle.
    Dim rect As New Rectangle(0, 0, 200, 200)

    ' Fill rectangle to screen.
    e.Graphics.FillRectangle(blueBrush, rect)
End Sub

Remarks

This method fills the interior of the rectangle defined by the rect parameter, including the specified upper-left corner and up to the calculated lower and bottom edges.

Applies to

.NET 9 (package-provided) and other versions

Product	Versions
.NET	8 (package-provided), 9 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

FillRectangle(Brush, RectangleF)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Fills the interior of a rectangle specified by a RectangleF structure.

public:
 void FillRectangle(System::Drawing::Brush ^ brush, System::Drawing::RectangleF rect);

public void FillRectangle(System.Drawing.Brush brush, System.Drawing.RectangleF rect);

member this.FillRectangle : System.Drawing.Brush * System.Drawing.RectangleF -> unit

Public Sub FillRectangle (brush As Brush, rect As RectangleF)

Parameters

brush: Brush

Brush that determines the characteristics of the fill.

rect: RectangleF

RectangleF structure that represents the rectangle to fill.

Exceptions

ArgumentNullException

brush 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.
Fills the rectangular area on the screen.

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

      // Create rectangle.
      RectangleF rect = RectangleF(0.0F,0.0F,200.0F,200.0F);

      // Fill rectangle to screen.
      e->Graphics->FillRectangle( blueBrush, rect );
   }

private void FillRectangleRectangleF(PaintEventArgs e)
{

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

    // Create rectangle.
    RectangleF rect = new RectangleF(0.0F, 0.0F, 200.0F, 200.0F);

    // Fill rectangle to screen.
    e.Graphics.FillRectangle(blueBrush, rect);
}

Private Sub FillRectangleRectangleF(ByVal e As PaintEventArgs)

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

    ' Create rectangle.
    Dim rect As New RectangleF(0.0F, 0.0F, 200.0F, 200.0F)

    ' Fill rectangle to screen.
    e.Graphics.FillRectangle(blueBrush, rect)
End Sub

Remarks

This method fills the interior of the rectangle defined by the rect parameter, including the specified upper-left corner and up to the calculated lower and bottom edges.

Applies to

.NET 9 (package-provided) and other versions

Product	Versions
.NET	8 (package-provided), 9 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

FillRectangle(Brush, Int32, Int32, Int32, Int32)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height.

public:
 void FillRectangle(System::Drawing::Brush ^ brush, int x, int y, int width, int height);

public void FillRectangle(System.Drawing.Brush brush, int x, int y, int width, int height);

member this.FillRectangle : System.Drawing.Brush * int * int * int * int -> unit

Public Sub FillRectangle (brush As Brush, x As Integer, y As Integer, width As Integer, height As Integer)

Parameters

brush: Brush

Brush that determines the characteristics of the fill.

x: Int32

The x-coordinate of the upper-left corner of the rectangle to fill.

y: Int32

The y-coordinate of the upper-left corner of the rectangle to fill.

width: Int32

Width of the rectangle to fill.

height: Int32

Height of the rectangle to fill.

Exceptions

ArgumentNullException

brush 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 the location and size of a rectangle.
Fills the rectangular area on the screen.

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

      // Create location and size of rectangle.
      int x = 0;
      int y = 0;
      int width = 200;
      int height = 200;

      // Fill rectangle to screen.
      e->Graphics->FillRectangle( blueBrush, x, y, width, height );
   }

private void FillRectangleInt(PaintEventArgs e)
{

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

    // Create location and size of rectangle.
    int x = 0;
    int y = 0;
    int width = 200;
    int height = 200;

    // Fill rectangle to screen.
    e.Graphics.FillRectangle(blueBrush, x, y, width, height);
}

Private Sub FillRectangleInt(ByVal e As PaintEventArgs)

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

    ' Create location and size of rectangle.
    Dim x As Integer = 0
    Dim y As Integer = 0
    Dim width As Integer = 200
    Dim height As Integer = 200

    ' Fill rectangle to screen.
    e.Graphics.FillRectangle(blueBrush, x, y, width, height)
End Sub

Remarks

This method fills the interior of the rectangle defined by thex, y, width, and height parameters, including the specified upper-left corner and up to the calculated lower and bottom edges.

Applies to

.NET 9 (package-provided) and other versions

Product	Versions
.NET	8 (package-provided), 9 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

FillRectangle(Brush, Single, Single, Single, Single)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Fills the interior of a rectangle specified by a pair of coordinates, a width, and a height.

public:
 void FillRectangle(System::Drawing::Brush ^ brush, float x, float y, float width, float height);

public void FillRectangle(System.Drawing.Brush brush, float x, float y, float width, float height);

member this.FillRectangle : System.Drawing.Brush * single * single * single * single -> unit

Public Sub FillRectangle (brush As Brush, x As Single, y As Single, width As Single, height As Single)

Parameters

brush: Brush

Brush that determines the characteristics of the fill.

x: Single

The x-coordinate of the upper-left corner of the rectangle to fill.

y: Single

The y-coordinate of the upper-left corner of the rectangle to fill.

width: Single

Width of the rectangle to fill.

height: Single

Height of the rectangle to fill.

Exceptions

ArgumentNullException

brush 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 the location and size of a rectangle.
Fills the rectangular area on the screen.

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

      // Create location and size of rectangle.
      float x = 0.0F;
      float y = 0.0F;
      float width = 200.0F;
      float height = 200.0F;

      // Fill rectangle to screen.
      e->Graphics->FillRectangle( blueBrush, x, y, width, height );
   }

private void FillRectangleFloat(PaintEventArgs e)
{

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

    // Create location and size of rectangle.
    float x = 0.0F;
    float y = 0.0F;
    float width = 200.0F;
    float height = 200.0F;

    // Fill rectangle to screen.
    e.Graphics.FillRectangle(blueBrush, x, y, width, height);
}

Private Sub FillRectangleFloat(ByVal e As PaintEventArgs)

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

    ' Create location and size of rectangle.
    Dim x As Single = 0.0F
    Dim y As Single = 0.0F
    Dim width As Single = 200.0F
    Dim height As Single = 200.0F

    ' Fill rectangle to screen.
    e.Graphics.FillRectangle(blueBrush, x, y, width, height)
End Sub

Remarks

This method fills the interior of the rectangle defined by the x, y, width, and height parameters, including the specified upper-left corner and up to the calculated lower and bottom edges.

Applies to

.NET 9 (package-provided) and other versions

Product	Versions
.NET	8 (package-provided), 9 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Share via

Graphics.FillRectangle Method

Definition

Overloads

FillRectangle(Brush, Rectangle)

Parameters

Exceptions

Examples

Remarks

Applies to

FillRectangle(Brush, RectangleF)

Parameters

Exceptions

Examples

Remarks

Applies to

FillRectangle(Brush, Int32, Int32, Int32, Int32)

Parameters

Exceptions

Examples

Remarks

Applies to

FillRectangle(Brush, Single, Single, Single, Single)

Parameters

Exceptions

Examples

Remarks

Applies to

Additional resources