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)
Public Sub DrawRectangle ( pen As Pen, x As Single, y As Single, width As Single, height As Single )
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, 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 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
Available since 1.1