Rectangle Struct

Definition

public value class Rectangle : IEquatable<System::Drawing::Rectangle>

public value class Rectangle

[System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]public struct Rectangle : IEquatable<System.Drawing.Rectangle>

public struct Rectangle

public struct Rectangle : IEquatable<System.Drawing.Rectangle>

[System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))][System.Runtime.InteropServices.ComVisible(true)][System.Serializable]public struct Rectangle

[<System.ComponentModel.TypeConverter("System.Drawing.RectangleConverter, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]type Rectangle = struct

type Rectangle = struct

[<System.ComponentModel.TypeConverter(typeof(System.Drawing.RectangleConverter))>][<System.Runtime.InteropServices.ComVisible(true)>][<System.Serializable>]type Rectangle = struct

Public Structure RectangleImplements IEquatable(Of Rectangle)

Public Structure Rectangle

Inheritance

Object

ValueType

Rectangle

Attributes

TypeConverterAttributeComVisibleAttributeSerializableAttribute

Implements

IEquatable<Rectangle>

Examples

The following example draws a rectangle with its upper-left corner at (10, 10). The rectangle has a width of 100 and a height of 50. The second argument passed to thePen constructor indicates that the pen width is 5 pixels.

When the rectangle is drawn, the pen is centered on the rectangle's boundary. Because the pen width is 5, the sides of the rectangle are drawn 5 pixels wide, such that 1 pixel is drawn on the boundary itself, 2 pixels are drawn on the inside, and 2 pixels are drawn on the outside. For more details on pen alignment, seeHow to: Set Pen Width and Alignment.

The following illustration shows the resulting rectangle. The dotted lines show where the rectangle would have been drawn if the pen width had been one pixel. The enlarged view of the upper-left corner of the rectangle shows that the thick black lines are centered on those dotted lines.

The example is designed for use with Windows Forms, and it requiresPaintEventArgse, which is a parameter of thePaint event handler.

Pen blackPen = new Pen(Color.FromArgb(255, 0, 0, 0), 5);e.Graphics.DrawRectangle(blackPen, 10, 10, 100, 50);

Dim blackPen As New Pen(Color.FromArgb(255, 0, 0, 0), 5)e.Graphics.DrawRectangle(blackPen, 10, 10, 100, 50)

Remarks

A rectangle is defined by itsWidth,Height, and upper-left corner represented by theLocation property.

To draw rectangles, you need aGraphics object and aPen object. TheGraphics object provides theDrawRectangle method, and thePen object stores features of the line, such as color and width. The units the rectangle is drawn in is determined by thePageUnit andPageScale properties of the graphics object used for drawing. The default unit is pixels.

To draw aRectangle filled with color, you need aGraphics object and an object derived fromBrush such asSolidBrush orLinearGradientBrush. TheGraphics object provides theFillRectangle method and theBrush object provides the color and fill information.

For more advanced shapes, use aRegion object.