Graphics.DrawRectangle Graphics.DrawRectangle Graphics.DrawRectangle Method

Definition

Draws a rectangle specified by a coordinate pair, a width, and a height.

Overloads

DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle)

Draws a rectangle specified by a Rectangle structure.

DrawRectangle(Pen, Int32, Int32, Int32, Int32) DrawRectangle(Pen, Int32, Int32, Int32, Int32) DrawRectangle(Pen, Int32, Int32, Int32, Int32)

Draws a rectangle specified by a coordinate pair, a width, and a height.

DrawRectangle(Pen, Single, Single, Single, Single) DrawRectangle(Pen, Single, Single, Single, Single) DrawRectangle(Pen, Single, Single, Single, Single)

Draws a rectangle specified by a coordinate pair, a width, and a height.

DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle) DrawRectangle(Pen, Rectangle)

Draws a rectangle specified by a Rectangle structure.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, System::Drawing::Rectangle rect);
public void DrawRectangle (System.Drawing.Pen pen, System.Drawing.Rectangle rect);
member this.DrawRectangle : System.Drawing.Pen * System.Drawing.Rectangle -> unit

Parameters

pen
Pen Pen Pen

A Pen that determines the color, width, and style of the rectangle.

rect
Rectangle Rectangle Rectangle

A Rectangle structure that represents the rectangle to draw.

Exceptions

Examples

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 black pen.

  • Creates a rectangle.

  • Draws the rectangle to the screen.

public:
   void DrawRectangleRectangle( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

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

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, rect );
   }
public void DrawRectangleRectangle(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create rectangle.
    Rectangle rect = new Rectangle(0, 0, 200, 200);
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, rect);
}
Public Sub DrawRectangleRectangle(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

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

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, rect)
End Sub

Remarks

For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

DrawRectangle(Pen, Int32, Int32, Int32, Int32) DrawRectangle(Pen, Int32, Int32, Int32, Int32) DrawRectangle(Pen, Int32, Int32, Int32, Int32)

Draws a rectangle specified by a coordinate pair, a width, and a height.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, int x, int y, int width, int height);
public void DrawRectangle (System.Drawing.Pen pen, int x, int y, int width, int height);
member this.DrawRectangle : System.Drawing.Pen * int * int * int * int -> unit

Parameters

pen
Pen Pen Pen

Pen that determines the color, width, and style of the rectangle.

x
Int32 Int32 Int32

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

y
Int32 Int32 Int32

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

width
Int32 Int32 Int32

Width of the rectangle to draw.

height
Int32 Int32 Int32

Height of the rectangle to draw.

Exceptions

Examples

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 black pen.

  • Creates the position and size of a rectangle.

  • Draws the rectangle to the screen.

public:
   void DrawRectangleInt( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

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

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );
   }
public void DrawRectangleInt(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of rectangle.
    int x = 0;
    int y = 0;
    int width = 200;
    int height = 200;
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
}
Public Sub DrawRectangleInt(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' 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

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)
End Sub

Remarks

For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

DrawRectangle(Pen, Single, Single, Single, Single) DrawRectangle(Pen, Single, Single, Single, Single) DrawRectangle(Pen, Single, Single, Single, Single)

Draws a rectangle specified by a coordinate pair, a width, and a height.

public:
 void DrawRectangle(System::Drawing::Pen ^ pen, float x, float y, float width, float height);
public void DrawRectangle (System.Drawing.Pen pen, float x, float y, float width, float height);
member this.DrawRectangle : System.Drawing.Pen * single * single * single * single -> unit

Parameters

pen
Pen Pen Pen

A Pen that determines the color, width, and style of the rectangle.

x
Single Single Single

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

y
Single Single Single

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

width
Single Single Single

The width of the rectangle to draw.

height
Single Single Single

The height of the rectangle to draw.

Exceptions

Examples

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 black pen.

  • Creates the position and size of a rectangle.

  • Draws the rectangle to the screen.

public:
   void DrawRectangleFloat( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

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

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );
   }
public void DrawRectangleFloat(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create location and size of rectangle.
    float x = 0.0F;
    float y = 0.0F;
    float width = 200.0F;
    float height = 200.0F;
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
}
Public Sub DrawRectangleFloat(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' 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

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)
End Sub

Remarks

For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).

Applies to