Graphics.DrawRectangle Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Draws a rectangle specified by a coordinate pair, a width, and a height.
Overloads
DrawRectangle(Pen, Int32, Int32, Int32, Int32) |
Draws a rectangle specified by a coordinate pair, a width, and a height. |
DrawRectangle(Pen, Single, Single, Single, Single) |
Draws a rectangle specified by a coordinate pair, a width, and a height. |
DrawRectangle(Pen, RectangleF) |
Draws the outline of the specified rectangle. |
DrawRectangle(Pen, Rectangle) |
Draws a rectangle specified by a Rectangle structure. |
DrawRectangle(Pen, Int32, Int32, Int32, Int32)
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
Draws a rectangle specified by a coordinate pair, a width, and a height.
public:
void DrawRectangle(System::Drawing::Pen ^ pen, int x, int y, int width, int height);
public void DrawRectangle (System.Drawing.Pen pen, int x, int y, int width, int height);
member this.DrawRectangle : System.Drawing.Pen * int * int * int * int -> unit
Public Sub DrawRectangle (pen As Pen, x As Integer, y As Integer, width As Integer, height As Integer)
Parameters
- x
- Int32
The x-coordinate of the upper-left corner of the rectangle to draw.
- y
- Int32
The y-coordinate of the upper-left corner of the rectangle to draw.
- width
- Int32
Width of the rectangle to draw.
- height
- Int32
Height of the rectangle to draw.
Exceptions
pen
is null
.
Examples
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 DrawRectangleInt( PaintEventArgs^ e )
{
// Create pen.
Pen^ blackPen = gcnew Pen( Color::Black,3.0f );
// Create location and size of rectangle.
int x = 0;
int y = 0;
int width = 200;
int height = 200;
// Draw rectangle to screen.
e->Graphics->DrawRectangle( blackPen, x, y, width, height );
}
public void DrawRectangleInt(PaintEventArgs e)
{
// Create pen.
Pen blackPen = new Pen(Color.Black, 3);
// Create location and size of rectangle.
int x = 0;
int y = 0;
int width = 200;
int height = 200;
// Draw rectangle to screen.
e.Graphics.DrawRectangle(blackPen, x, y, width, height);
}
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
Remarks
For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).
Applies to
DrawRectangle(Pen, Single, Single, Single, Single)
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
Draws a rectangle specified by a coordinate pair, a width, and a height.
public:
void DrawRectangle(System::Drawing::Pen ^ pen, float x, float y, float width, float height);
public void DrawRectangle (System.Drawing.Pen pen, float x, float y, float width, float height);
member this.DrawRectangle : System.Drawing.Pen * single * single * single * single -> unit
Public Sub DrawRectangle (pen As Pen, x As Single, y As Single, width As Single, height As Single)
Parameters
- x
- Single
The x-coordinate of the upper-left corner of the rectangle to draw.
- y
- Single
The y-coordinate of the upper-left corner of the rectangle to draw.
- width
- Single
The width of the rectangle to draw.
- height
- Single
The height of the rectangle to draw.
Exceptions
pen
is null
.
Examples
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 );
}
public void DrawRectangleFloat(PaintEventArgs e)
{
// Create pen.
Pen blackPen = new Pen(Color.Black, 3);
// 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);
}
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
Remarks
For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).
Applies to
DrawRectangle(Pen, RectangleF)
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
Draws the outline of the specified rectangle.
public:
void DrawRectangle(System::Drawing::Pen ^ pen, System::Drawing::RectangleF rect);
public void DrawRectangle (System.Drawing.Pen pen, System.Drawing.RectangleF rect);
member this.DrawRectangle : System.Drawing.Pen * System.Drawing.RectangleF -> unit
Public Sub DrawRectangle (pen As Pen, rect As RectangleF)
Parameters
- pen
- Pen
A pen that determines the color, width, and style of the rectangle.
- rect
- RectangleF
The rectangle to draw.
Applies to
DrawRectangle(Pen, Rectangle)
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
- Source:
- Graphics.cs
Draws a rectangle specified by a Rectangle structure.
public:
void DrawRectangle(System::Drawing::Pen ^ pen, System::Drawing::Rectangle rect);
public void DrawRectangle (System.Drawing.Pen pen, System.Drawing.Rectangle rect);
member this.DrawRectangle : System.Drawing.Pen * System.Drawing.Rectangle -> unit
Public Sub DrawRectangle (pen As Pen, rect As Rectangle)
Parameters
Exceptions
pen
is null
.
Examples
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 a rectangle.
Draws the rectangle to the screen.
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.Black, 3);
// Create rectangle.
Rectangle rect = new Rectangle(0, 0, 200, 200);
// Draw rectangle to screen.
e.Graphics.DrawRectangle(blackPen, rect);
}
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
Remarks
For information about how to draw a RectangleF, see DrawRectangles(Pen, RectangleF[]).