Graphics::DrawRectangle Method (Pen^, Single, Single, Single, Single)
Draws a rectangle specified by a coordinate pair, a width, and a height.
Assembly: System.Drawing (in System.Drawing.dll)
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.
| 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 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 ); }
Available since 1.1