Graphics.DrawRectangle Method (Pen, Rectangle) (System.Drawing)

Microsoft Developer Network

DrawRectangle Method (Pen, Rectangle)

Graphics.DrawRectangle Method (Pen, Rectangle)

Draws a rectangle specified by a Rectangle structure.

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

Syntax

Visual Basic (Declaration)

Public Sub DrawRectangle ( _
    pen As Pen, _
    rect As Rectangle _
)

Visual Basic (Usage)

Dim instance As Graphics
Dim pen As Pen
Dim rect As Rectangle

instance.DrawRectangle(pen, rect)

public void DrawRectangle (
    Pen pen,
    Rectangle rect
)

C++

public:
void DrawRectangle (
    Pen^ pen, 
    Rectangle rect
)

public void DrawRectangle (
    Pen pen, 
    Rectangle rect
)

JScript

public function DrawRectangle (
    pen : Pen, 
    rect : Rectangle
)

XAML

Not applicable.

Parameters

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

rect: A Rectangle structure that represents the rectangle to draw.

Exceptions

Exception type	Condition
ArgumentNullException	pen is a null reference (Nothing in Visual Basic).

Example

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 a rectangle.
Draws the rectangle to the screen.

Visual Basic

Public Sub DrawRectangleRectangle(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create rectangle.
    Dim rect As New Rectangle(0, 0, 200, 200)

    ' Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, rect)
End Sub

public void DrawRectangleRectangle(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create rectangle.
    Rectangle rect = new Rectangle(0, 0, 200, 200);
             
    // Draw rectangle to screen.
    e.Graphics.DrawRectangle(blackPen, rect);
}

C++

public:
   void DrawRectangleRectangle( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create rectangle.
      Rectangle rect = Rectangle(0,0,200,200);

      // Draw rectangle to screen.
      e->Graphics->DrawRectangle( blackPen, rect );
   }

public void DrawRectangleRectangle(PaintEventArgs e) 
{
    // Create pen.
    Pen blackPen =  new Pen(Color.get_Black(), 3);

    // Create rectangle.
    Rectangle rect =  new Rectangle(0, 0, 200, 200);

    // Draw rectangle to screen.
    e.get_Graphics().DrawRectangle(blackPen, rect);
} //DrawRectangleRectangle

Platforms

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Reference

Graphics Class
Graphics Members
System.Drawing Namespace