Rectangle Structure
Namespace: System.Drawing
Represents a graphics location and size, expressed as a set of four integers. A Rectangle
structure can be used to store the upper-left corner coordinates, the width, and the height of a rectangle.
Example:
Create a rectangle with its upper-left corner at (10, 20) and a width and height of 100 and 50 respectively.
Create a rectangle with its upper-left corner at (10, 20) and a width and height of 100 and 50 respectively.
using System.Drawing;
// ...
Rectangle rect = new Rectangle(10, 20, 100, 50);
// Or
Rectangle rect2 = new Rectangle(new Point(10, 20), new Size(100, 50));
Fields
Name | Type | Description |
---|---|---|
Empty | static readonly Rectangle | Represents a rectangle with no location or size. This is a read-only field. |
X | int | Gets or sets the x-coordinate of the upper-left corner of this Rectangle structure. |
Y | int | Gets or sets the y-coordinate of the upper-left corner of this Rectangle structure. |
Width | int | Gets or sets the width of this Rectangle structure. Width must be non-negative. |
Height | int | Gets or sets the height of this Rectangle structure. Height must be non-negative. |
Constructors
Name | Description |
---|---|
Rectangle(int x, int y, int width, int height) | Initializes a new instance of the Rectangle structure with the specified location and size. |
Rectangle(Point location, Size size) | Initializes a new instance of the Rectangle structure with the specified location and size. |
Properties
Name | Type | Description |
---|---|---|
Bottom | int | Gets the y-coordinate of the lower edge of this Rectangle structure. |
Left | int | Gets the x-coordinate of the left edge of this Rectangle structure. |
Right | int | Gets the x-coordinate of the right edge of this Rectangle structure. |
Top | int | Gets the y-coordinate of the upper edge of this Rectangle structure. |
Location | Point | Gets or sets the coordinates of the upper-left corner of this Rectangle structure. |
Size | Size | Gets or sets the width and height of this Rectangle structure. |
IsEmpty | bool | Gets a value indicating whether this Rectangle structure has a width of 0 and a height of 0 and a location at (0,0). |
Methods
Name | Description |
---|---|
Contains(int x, int y) | Determines whether the specified point is contained within this Rectangle structure. |
Contains(Point pt) | Determines whether the specified point is contained within this Rectangle structure. |
Inflate(int width, int height) | Inflates this Rectangle by the specified amount. |
Intersect(Rectangle rect1, Rectangle rect2) | Returns a Rectangle structure that represents the intersection of two rectangles. If there is no intersection, an empty Rectangle is returned. |
Offset(Point pos) | Adjusts the position of this Rectangle by the specified offset. |
Offset(int x, int y) | Adjusts the position of this Rectangle by the specified offset. |
Union(Rectangle rect1, Rectangle rect2) | Returns a Rectangle structure that represents the union of two rectangles. |
Note: Ensure that width and height values are non-negative.