//
// System.Drawing.Rectangle.cs
//
// Author:
// Mike Kestner (mkestner@speakeasy.net)
//
// Copyright (C) 2001 Mike Kestner
// Copyright (C) 2004 Novell, Inc. http://www.novell.com
//
//
// Copyright (C) 2004 Novell, Inc (http://www.novell.com)
//
// Permission is hereby granted, free of charge, to any person obtaining
// a copy of this software and associated documentation files (the
// "Software"), to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify, merge, publish,
// distribute, sublicense, and/or sell copies of the Software, and to
// permit persons to whom the Software is furnished to do so, subject to
// the following conditions:
//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
using System;
using System.Runtime.InteropServices;
using System.ComponentModel;
namespace System.Drawing
{
[Serializable]
[ComVisible (true)]
[TypeConverter (typeof (RectangleConverter))]
public struct Rectangle
{
private int x, y, width, height;
///
/// Empty Shared Field
///
///
///
/// An uninitialized Rectangle Structure.
///
public static readonly Rectangle Empty;
#if TARGET_JVM
internal java.awt.Rectangle NativeObject {
get {
return new java.awt.Rectangle(X,Y,Width,Height);
}
}
#endif
///
/// Ceiling Shared Method
///
///
///
/// Produces a Rectangle structure from a RectangleF
/// structure by taking the ceiling of the X, Y, Width,
/// and Height properties.
///
public static Rectangle Ceiling (RectangleF value)
{
int x, y, w, h;
checked {
x = (int) Math.Ceiling (value.X);
y = (int) Math.Ceiling (value.Y);
w = (int) Math.Ceiling (value.Width);
h = (int) Math.Ceiling (value.Height);
}
return new Rectangle (x, y, w, h);
}
///
/// FromLTRB Shared Method
///
///
///
/// Produces a Rectangle structure from left, top, right,
/// and bottom coordinates.
///
public static Rectangle FromLTRB (int left, int top,
int right, int bottom)
{
return new Rectangle (left, top, right - left,
bottom - top);
}
///
/// Inflate Shared Method
///
///
///
/// Produces a new Rectangle by inflating an existing
/// Rectangle by the specified coordinate values.
///
public static Rectangle Inflate (Rectangle rect, int x, int y)
{
Rectangle r = new Rectangle (rect.Location, rect.Size);
r.Inflate (x, y);
return r;
}
///
/// Inflate Method
///
///
///
/// Inflates the Rectangle by a specified width and height.
///
public void Inflate (int width, int height)
{
Inflate (new Size (width, height));
}
///
/// Inflate Method
///
///
///
/// Inflates the Rectangle by a specified Size.
///
public void Inflate (Size sz)
{
x -= sz.Width;
y -= sz.Height;
Width += sz.Width * 2;
Height += sz.Height * 2;
}
///
/// Intersect Shared Method
///
///
///
/// Produces a new Rectangle by intersecting 2 existing
/// Rectangles. Returns null if there is no intersection.
///
public static Rectangle Intersect (Rectangle r1, Rectangle r2)
{
// MS.NET returns a non-empty rectangle if the two rectangles
// touch each other
if (!r1.IntersectsWithInclusive (r2))
return Empty;
return Rectangle.FromLTRB (
Math.Max (r1.Left, r2.Left),
Math.Max (r1.Top, r2.Top),
Math.Min (r1.Right, r2.Right),
Math.Min (r1.Bottom, r2.Bottom));
}
///
/// Intersect Method
///
///
///
/// Replaces the Rectangle with the intersection of itself
/// and another Rectangle.
///
public void Intersect (Rectangle r)
{
this = Rectangle.Intersect (this, r);
}
///
/// Round Shared Method
///
///
///
/// Produces a Rectangle structure from a RectangleF by
/// rounding the X, Y, Width, and Height properties.
///
public static Rectangle Round (RectangleF value)
{
int x, y, w, h;
checked {
x = (int) Math.Round (value.X);
y = (int) Math.Round (value.Y);
w = (int) Math.Round (value.Width);
h = (int) Math.Round (value.Height);
}
return new Rectangle (x, y, w, h);
}
///
/// Truncate Shared Method
///
///
///
/// Produces a Rectangle structure from a RectangleF by
/// truncating the X, Y, Width, and Height properties.
///
// LAMESPEC: Should this be floor, or a pure cast to int?
public static Rectangle Truncate (RectangleF value)
{
int x, y, w, h;
checked {
x = (int) value.X;
y = (int) value.Y;
w = (int) value.Width;
h = (int) value.Height;
}
return new Rectangle (x, y, w, h);
}
///
/// Union Shared Method
///
///
///
/// Produces a new Rectangle from the union of 2 existing
/// Rectangles.
///
public static Rectangle Union (Rectangle r1, Rectangle r2)
{
return FromLTRB (Math.Min (r1.Left, r2.Left),
Math.Min (r1.Top, r2.Top),
Math.Max (r1.Right, r2.Right),
Math.Max (r1.Bottom, r2.Bottom));
}
///
/// Equality Operator
///
///
///
/// Compares two Rectangle objects. The return value is
/// based on the equivalence of the Location and Size
/// properties of the two Rectangles.
///
public static bool operator == (Rectangle r1, Rectangle r2)
{
return ((r1.Location == r2.Location) &&
(r1.Size == r2.Size));
}
///
/// Inequality Operator
///
///
///
/// Compares two Rectangle objects. The return value is
/// based on the equivalence of the Location and Size
/// properties of the two Rectangles.
///
public static bool operator != (Rectangle r1, Rectangle r2)
{
return ((r1.Location != r2.Location) ||
(r1.Size != r2.Size));
}
// -----------------------
// Public Constructors
// -----------------------
///
/// Rectangle Constructor
///
///
///
/// Creates a Rectangle from Point and Size values.
///
public Rectangle (Point loc, Size sz)
{
x = loc.X;
y = loc.Y;
width = sz.Width;
height = sz.Height;
}
///
/// Rectangle Constructor
///
///
///
/// Creates a Rectangle from a specified x,y location and
/// width and height values.
///
public Rectangle (int x, int y, int width, int height)
{
this.x = x;
this.y = y;
this.width = width;
this.height = height;
}
///
/// Bottom Property
///
///
///
/// The Y coordinate of the bottom edge of the Rectangle.
/// Read only.
///
[Browsable (false)]
public int Bottom {
get {
return y + height;
}
}
///
/// Height Property
///
///
///
/// The Height of the Rectangle.
///
public int Height {
get {
return height;
}
set {
height = value;
}
}
///
/// IsEmpty Property
///
///
///
/// Indicates if the width or height are zero. Read only.
///
[Browsable (false)]
public bool IsEmpty {
get {
return ((x == 0) && (y == 0) && (width == 0) && (height == 0));
}
}
///
/// Left Property
///
///
///
/// The X coordinate of the left edge of the Rectangle.
/// Read only.
///
[Browsable (false)]
public int Left {
get {
return X;
}
}
///
/// Location Property
///
///
///
/// The Location of the top-left corner of the Rectangle.
///
[Browsable (false)]
public Point Location {
get {
return new Point (x, y);
}
set {
x = value.X;
y = value.Y;
}
}
///
/// Right Property
///
///
///
/// The X coordinate of the right edge of the Rectangle.
/// Read only.
///
[Browsable (false)]
public int Right {
get {
return X + Width;
}
}
///
/// Size Property
///
///
///
/// The Size of the Rectangle.
///
[Browsable (false)]
public Size Size {
get {
return new Size (Width, Height);
}
set {
Width = value.Width;
Height = value.Height;
}
}
///
/// Top Property
///
///
///
/// The Y coordinate of the top edge of the Rectangle.
/// Read only.
///
[Browsable (false)]
public int Top {
get {
return y;
}
}
///
/// Width Property
///
///
///
/// The Width of the Rectangle.
///
public int Width {
get {
return width;
}
set {
width = value;
}
}
///
/// X Property
///
///
///
/// The X coordinate of the Rectangle.
///
public int X {
get {
return x;
}
set {
x = value;
}
}
///
/// Y Property
///
///
///
/// The Y coordinate of the Rectangle.
///
public int Y {
get {
return y;
}
set {
y = value;
}
}
///
/// Contains Method
///
///
///
/// Checks if an x,y coordinate lies within this Rectangle.
///
public bool Contains (int x, int y)
{
return ((x >= Left) && (x < Right) &&
(y >= Top) && (y < Bottom));
}
///
/// Contains Method
///
///
///
/// Checks if a Point lies within this Rectangle.
///
public bool Contains (Point pt)
{
return Contains (pt.X, pt.Y);
}
///
/// Contains Method
///
///
///
/// Checks if a Rectangle lies entirely within this
/// Rectangle.
///
public bool Contains (Rectangle rect)
{
return (rect == Intersect (this, rect));
}
///
/// Equals Method
///
///
///
/// Checks equivalence of this Rectangle and another object.
///
public override bool Equals (object o)
{
if (!(o is Rectangle))
return false;
return (this == (Rectangle) o);
}
///
/// GetHashCode Method
///
///
///
/// Calculates a hashing value.
///
public override int GetHashCode ()
{
return (height + width) ^ x + y;
}
///
/// IntersectsWith Method
///
///
///
/// Checks if a Rectangle intersects with this one.
///
public bool IntersectsWith (Rectangle r)
{
return !((Left >= r.Right) || (Right <= r.Left) ||
(Top >= r.Bottom) || (Bottom <= r.Top));
}
private bool IntersectsWithInclusive (Rectangle r)
{
return !((Left > r.Right) || (Right < r.Left) ||
(Top > r.Bottom) || (Bottom < r.Top));
}
///
/// Offset Method
///
///
///
/// Moves the Rectangle a specified distance.
///
public void Offset (int dx, int dy)
{
x += dx;
y += dy;
}
///
/// Offset Method
///
///
///
/// Moves the Rectangle a specified distance.
///
public void Offset (Point pt)
{
x += pt.X;
y += pt.Y;
}
///
/// ToString Method
///
///
///
/// Formats the Rectangle as a string in (x,y,w,h) notation.
///
public override string ToString ()
{
return String.Format ("{{X={0},Y={1},Width={2},Height={3}}}",
x, y, width, height);
}
}
}