Graphics.DrawRectangle Method (Pen, Int32, Int32, Int32, Int32)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

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

Public Sub DrawRectangle (
	pen As Pen,
	x As Integer,
	y As Integer,
	width As Integer,
	height As Integer
)

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, 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 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

.NET Framework
Available since 1.1
Return to top
Show: