Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Graphics::DrawRectangle Method (Pen, Single, Single, Single, Single)

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, 
	float x, 
	float y, 
	float width, 
	float height
)

Parameters

pen
Type: System.Drawing::Pen

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

x
Type: System::Single

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

y
Type: System::Single

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

width
Type: System::Single

The width of the rectangle to draw.

height
Type: System::Single

The height of the rectangle to draw.

ExceptionCondition
ArgumentNullException

pen is nullptr.

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 PaintEventArgs e, 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 );
   }

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft