The x, y, width, and
height properties of the Rectangle class are independent of
each other; changing the value of one property has no effect on the others.
However, the right and bottom properties are
integrally related to those four properties. For example, if you change the
value of the right property, the value of the
width property changes; if you change the bottom
property, the value of the height property changes.
The following methods and properties use Rectangle objects:
applyFilter(), colorTransform(),
copyChannel(), copyPixels(), draw(),
fillRect(), generateFilterRect(),
getColorBoundsRect(), getPixels(),
merge(), paletteMap(),
pixelDisolve(), setPixels(), and
threshold() methods, and the rect property of the
BitmapData classgetBounds() and getRect() methods, and
the scrollRect and scale9Grid properties of the
DisplayObject classgetCharBoundaries() method of the TextField
classpixelBounds property of the Transform classbounds parameter for the startDrag()
method of the Sprite classprintArea parameter of the addPage()
method of the PrintJob classYou can use the new Rectangle() constructor to create a
Rectangle object.
Note: The Rectangle class does not define a rectangular Shape
display object. To draw a rectangular Shape object onscreen, use the
drawRect() method of the Graphics class.
y and height properties.right and bottom properties.height
value of a Rectangle object has no effect on the x,
y, and width properties.left property of a Rectangle object has no effect on the
y and height properties. However it does affect
the width property, whereas changing the x value
does not affect the width property.
The value of the left property is equal to the value of
the x property.
x and width properties.width and height properties.top property of a Rectangle object has no effect on the
x and width properties. However it does affect
the height property, whereas changing the y
value does not affect the height property.
The value of the top property is equal to the value of the
y property.
width
value of a Rectangle object has no effect on the x,
y, and height properties.x property of a Rectangle object has no
effect on the y, width, and height
properties.
The value of the x property is equal to the value of the
left property.
y property of a Rectangle object has no
effect on the x, width, and height
properties.
The value of the y property is equal to the value of the
top property.
x, y, width, and height properties as the original Rectangle object.x, y, width, and
height properties as the original Rectangle object.
x The x coordinate(horizontal position) of the point.y The y coordinate(vertical position) of the point.true if the Rectangle object contains the specified point; otherwise false.point The point, as represented by its x and y coordinates.true if the Rectangle object contains the specified point; otherwise false.Rectangle.contains() method, except that it takes a Point
object as a parameter.
rect The Rectangle object being checked.true if the Rectangle object that you specify is contained by this Rectangle object; otherwise false.rect
parameter is contained within this Rectangle object. A Rectangle object is
said to contain another if the second Rectangle object falls entirely
within the boundaries of the first.
toCompare The rectangle to compare to this Rectangle object.true if the object has exactly the same values for the x, y, width, and height properties as this Rectangle object; otherwise false.toCompare
parameter is equal to this Rectangle object. This method compares the
x, y, width, and
height properties of an object against the same properties of
this Rectangle object.
dx The value to be added to the left and the right of the Rectangle object. The following equation is used to calculate the new width and position of the rectangle:dy The value to be added to the top and the bottom of the Rectangle. The following equation is used to calculate the new height and position of the rectangle:dx value, and to
the top and the bottom by the dy value.
point The x property of this Point object is used to increase the horizontal dimension of the Rectangle object. The y property is used to increase the vertical dimension of the Rectangle object.Rectangle.inflate() method except it takes a Point object as
a parameter.
The following two code examples give the same result:
toIntersect The Rectangle object to compare against to see if it intersects with this Rectangle object.x, y, width, and height properties set to 0.toIntersect
parameter intersects with this Rectangle object, returns the area of
intersection as a Rectangle object. If the rectangles do not intersect,
this method returns an empty Rectangle object with its properties set to
0.
toIntersect The Rectangle object to compare against this Rectangle object.true if the specified object intersects with this Rectangle object; otherwise false.toIntersect
parameter intersects with this Rectangle object. This method checks the
x, y, width, and
height properties of the specified Rectangle object to see if
it intersects with this Rectangle object.
true if the Rectangle object's width or height is less than or equal to 0; otherwise false. This method sets the values of the x, y,
width, and height properties to 0.
x, y, width, and height.toUnion A Rectangle object to add to this Rectangle object.Note: The union() method ignores rectangles with
0 as the height or width value, such as: var
rect2:Rectangle = new Rectangle(300,300,50,0);
xandyparameters and with the specifiedwidthandheightparameters. If you call this function without parameters, a rectangle withx,y,width, andheightproperties set to 0 is created.