Graphics::DrawRectangle Method (Pen^, Int32, Int32, Int32, Int32)

 

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

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

public:
void DrawRectangle(
	Pen^ pen,
	int x,
	int y,
	int width,
	int height
)

Parameters

pen
Type: System.Drawing::Pen^

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

x
Type: System::Int32

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

y
Type: System::Int32

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

width
Type: System::Int32

Width of the rectangle to draw.

height
Type: System::Int32

Height of the rectangle to draw.

Exception Condition
ArgumentNullException

pen is null.

For information about how to draw a RectangleF, see DrawRectangles(Pen^, array<RectangleF>^).

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

.NET Framework
Available since 1.1
Return to top
Show: