flash.geom.Rectangle (ActionScript 3.0)

	属性	定义方
		bottom : Number y 和 height 属性的和。	Rectangle
		bottomRight : Point 由 right 和 bottom 属性的值确定的 Rectangle 对象的右下角的位置。	Rectangle
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		height : Number 矩形的高度（以像素为单位）。	Rectangle
		left : Number 矩形左上角的 x 坐标。	Rectangle
		prototype : Object [static] 对类或函数对象的原型对象的引用。	Object
		right : Number x 和 width 属性的和。	Rectangle
		size : Point Rectangle 对象的大小，该对象表示为具有 width 和 height 属性的值的 Point 对象。	Rectangle
		top : Number 矩形左上角的 y 坐标。	Rectangle
		topLeft : Point 由该点的 x 和 y 坐标确定的 Rectangle 对象左上角的位置。	Rectangle
		width : Number 矩形的宽度（以像素为单位）。	Rectangle
		x : Number 矩形左上角的 x 坐标。	Rectangle
		y : Number 矩形左上角的 y 坐标。	Rectangle

	方法	定义方
		Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0) 创建一个新 Rectangle 对象，其左上角由 x 和 y 参数指定，并具有指定的 width 和 height 参数。	Rectangle
		clone():Rectangle 返回一个新的 Rectangle 对象，其 x、y、width 和 height 属性的值与原始 Rectangle 对象的对应值相同。	Rectangle
		contains(x:Number, y:Number):Boolean 确定由此 Rectangle 对象定义的矩形区域内是否包含指定的点。	Rectangle
		containsPoint(point:Point):Boolean 确定由此 Rectangle 对象定义的矩形区域内是否包含指定的点。	Rectangle
		containsRect(rect:Rectangle):Boolean 确定此 Rectangle 对象内是否包含由 rect 参数指定的 Rectangle 对象。	Rectangle
		equals(toCompare:Rectangle):Boolean 确定在 toCompare 参数中指定的对象是否等于此 Rectangle 对象。	Rectangle
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		inflate(dx:Number, dy:Number):void 按指定量增加 Rectangle 对象的大小（以像素为单位）。	Rectangle
		inflatePoint(point:Point):void 增加 Rectangle 对象的大小。	Rectangle
		intersection(toIntersect:Rectangle):Rectangle 如果在 toIntersect 参数中指定的 Rectangle 对象与此 Rectangle 对象相交，则返回交集区域作为 Rectangle 对象。	Rectangle
		intersects(toIntersect:Rectangle):Boolean 确定在 toIntersect 参数中指定的对象是否与此 Rectangle 对象相交。	Rectangle
		isEmpty():Boolean 确定此 Rectangle 对象是否为空。	Rectangle
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		offset(dx:Number, dy:Number):void 按指定量调整 Rectangle 对象的位置（由其左上角确定）。	Rectangle
		offsetPoint(point:Point):void 将 Point 对象用作参数来调整 Rectangle 对象的位置。	Rectangle
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setEmpty():void 将 Rectangle 对象的所有属性设置为 0。	Rectangle
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toString():String 生成并返回一个字符串，该字符串列出 Rectangle 对象的水平位置和垂直位置以及高度和宽度。	Rectangle
		union(toUnion:Rectangle):Rectangle 通过填充两个矩形之间的水平和垂直空间，将这两个矩形组合在一起以创建一个新的 Rectangle 对象。	Rectangle
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

bottom

属性

bottom:Number [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

y 和 height 属性的和。

实现
public function get bottom():Number
public function set bottom(value:Number):void

另请参见

y
height
使用 Rectangle 对象

bottomRight

属性

bottomRight:Point [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

由 right 和 bottom 属性的值确定的 Rectangle 对象的右下角的位置。

实现
public function get bottomRight():Point
public function set bottomRight(value:Point):void

另请参见

flash.geom.Point

height

属性

public var height:Number

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

矩形的高度（以像素为单位）。更改 Rectangle 对象的 height 值对 x、y 和 width 属性没有影响。

另请参见

x
y
height
使用 Rectangle 对象

left

属性

left:Number [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

矩形左上角的 x 坐标。更改 Rectangle 对象的 left 属性对 y 和 height 属性没有影响。但是，它会影响 width 属性，而更改 x 值不会影响 width 属性。

left 属性的值等于 x 属性的值。

实现
public function get left():Number
public function set left(value:Number):void

另请参见

x
y
width
height
使用 Rectangle 对象

right

属性

right:Number [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

x 和 width 属性的和。

实现
public function get right():Number
public function set right(value:Number):void

另请参见

x
width
使用 Rectangle 对象

size

属性

size:Point [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

Rectangle 对象的大小，该对象表示为具有 width 和 height 属性的值的 Point 对象。

实现
public function get size():Point
public function set size(value:Point):void

另请参见

flash.geom.Point

top

属性

top:Number [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

矩形左上角的 y 坐标。更改 Rectangle 对象的 top 属性对 x 和 width 属性没有影响。但是，它会影响 height 属性，而更改 y 值不会影响 height 属性。

top 属性的值等于 y 属性的值。

实现
public function get top():Number
public function set top(value:Number):void

另请参见

x
y
width
height
使用 Rectangle 对象

topLeft

属性

topLeft:Point [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

由该点的 x 和 y 坐标确定的 Rectangle 对象左上角的位置。

实现
public function get topLeft():Point
public function set topLeft(value:Point):void

另请参见

flash.geom.Point
x
y

width

属性

public var width:Number

Player 版本 :

Flash Player 9

矩形的宽度（以像素为单位）。更改 Rectangle 对象的 width 值对 x、y 和 height 属性没有影响。

另请参见

x
y
height
使用 Rectangle 对象

属性

public var x:Number

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

矩形左上角的 x 坐标。更改 Rectangle 对象的 x 属性的值对 y、width 和 height 属性没有影响。

x 属性的值等于 left 属性的值。

另请参见

left
使用 Rectangle 对象

属性

public var y:Number

Player 版本 :

Flash Player 9

矩形左上角的 y 坐标。更改 Rectangle 对象的 y 属性的值对 x、width 和 height 属性没有影响。

y 属性的值等于 top 属性的值。

另请参见

x
width
height
top
使用 Rectangle 对象

构造函数详细信息

Rectangle

()

构造函数

public function Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

创建一个新 Rectangle 对象，其左上角由 x 和 y 参数指定，并具有指定的 width 和 height 参数。如果调用此函数时不使用任何参数，将创建一个 x、y、width 和 height 属性均设置为 0 的矩形。

参数

	`x:Number` (default = `0`) — 矩形左上角的 x 坐标。

	`y:Number` (default = `0`) — 矩形左上角的 y 坐标。

	`width:Number` (default = `0`) — 矩形的宽度（以像素为单位）。

	`height:Number` (default = `0`) — 矩形的高度（以像素为单位）。

另请参见

x
y
width
height

方法详细信息

clone

()

方法

public function clone():Rectangle

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

返回一个新的 Rectangle 对象，其 x、y、width 和 height 属性的值与原始 Rectangle 对象的对应值相同。

Rectangle — 新的 Rectangle 对象，其 x、y、width 和 height 属性的值与原始 Rectangle 对象的对应值相同。

另请参见

x
y
width
height

contains

()

方法

public function contains(x:Number, y:Number):Boolean

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

确定由此 Rectangle 对象定义的矩形区域内是否包含指定的点。

参数

	`x:Number` — 点的 x 坐标（水平位置）。

	`y:Number` — 点的 y 坐标（垂直位置）。

Boolean — 如果 Rectangle 对象包含指定的点，则值为 true；否则为 false。

另请参见

flash.geom.Point

containsPoint

()

方法

public function containsPoint(point:Point):Boolean

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

确定由此 Rectangle 对象定义的矩形区域内是否包含指定的点。此方法与 Rectangle.contains() 方法类似，只不过它采用 Point 对象作为参数。

参数

point:Point — 用其 x 和 y 坐标表示的点。

Boolean — 如果 Rectangle 对象包含指定的点，则值为 true；否则为 false。

另请参见

contains()
flash.geom.Point

containsRect

()

方法

public function containsRect(rect:Rectangle):Boolean

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

确定此 Rectangle 对象内是否包含由 rect 参数指定的 Rectangle 对象。如果一个 Rectangle 对象完全在另一个 Rectangle 的边界内，我们说第二个 Rectangle 包含第一个 Rectangle。

参数

rect:Rectangle — 所检查的 Rectangle 对象。

Boolean — 如果此 Rectangle 对象包含您指定的 Rectangle 对象，则返回 true 值，否则返回 false。

equals

()

方法

public function equals(toCompare:Rectangle):Boolean

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

确定在 toCompare 参数中指定的对象是否等于此 Rectangle 对象。此方法将某个对象的 x、y、width 和 height 属性与此 Rectangle 对象所对应的相同属性进行比较。

参数

toCompare:Rectangle — 要与此 Rectangle 对象进行比较的矩形。

Boolean — 如果对象具有与此 Rectangle 对象完全相同的 x、y、width 和 height 属性值，则返回 true 值，否则返回 false。

另请参见

x
y
width
height

inflate

()

方法

public function inflate(dx:Number, dy:Number):void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

按指定量增加 Rectangle 对象的大小（以像素为单位）。保持 Rectangle 对象的中心点不变，使用 dx 值横向增加它的大小，使用 dy 值纵向增加它的大小。

参数

	`dx:Number` — Rectangle 对象横向增加的值。下列等式用于计算矩形的新宽度和位置： x -= dx; width += 2 * dx;

	`dy:Number` — Rectangle 纵向增加的值。下列等式用于计算矩形的新高度和位置： y -= dy; height += 2 * dy;

另请参见

x
y
使用 Rectangle 对象

inflatePoint

()

方法

public function inflatePoint(point:Point):void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

增加 Rectangle 对象的大小。此方法与 Rectangle.inflate() 方法类似，只不过它采用 Point 对象作为参数。

下面的两个代码示例产生相同的结果：

  rect1=new flash.geom.Rectangle(0,0,2,5);
  rect1.inflate(2,2)

  rect1=new flash.geom.Rectangle(0,0,2,5);
  pt1=new flash.geom.Point(2,2);
  rect1.inflatePoint(pt1)

参数

point:Point — 此 Point 对象的 x 属性用于增加 Rectangle 对象的水平尺寸。 y 属性用于增加 Rectangle 对象的垂直尺寸。

另请参见

flash.geom.Point
使用 Rectangle 对象

intersection

()

方法

public function intersection(toIntersect:Rectangle):Rectangle

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

如果在 toIntersect 参数中指定的 Rectangle 对象与此 Rectangle 对象相交，则返回交集区域作为 Rectangle 对象。如果矩形不相交，则此方法返回一个空的 Rectangle 对象，其属性设置为 0。

参数

toIntersect:Rectangle — 要对照比较以查看其是否与此 Rectangle 对象相交的 Rectangle 对象。

Rectangle — 等于交集区域的 Rectangle 对象。如果该矩形不相交，则此方法返回一个空的 Rectangle 对象；即，其 x、y、width 和 height 属性均设置为 0 的矩形。

另请参见

使用 Rectangle 对象

intersects

()

方法

public function intersects(toIntersect:Rectangle):Boolean

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

确定在 toIntersect 参数中指定的对象是否与此 Rectangle 对象相交。此方法检查指定的 Rectangle 对象的 x、y、width 和 height 属性，以查看它是否与此 Rectangle 对象相交。

参数

toIntersect:Rectangle — 要与此 Rectangle 对象比较的 Rectangle 对象。

Boolean — 如果指定的对象与此 Rectangle 对象相交，则返回 true 值，否则返回 false。

另请参见

x
y
width
height
使用 Rectangle 对象

isEmpty

()

方法

public function isEmpty():Boolean

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

确定此 Rectangle 对象是否为空。

Boolean — 如果 Rectangle 对象的宽度或高度小于等于 0，则返回 true 值，否则返回 false。

offset

()

方法

public function offset(dx:Number, dy:Number):void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

按指定量调整 Rectangle 对象的位置（由其左上角确定）。

参数

	`dx:Number` — 将 Rectangle 对象的 x 值移动此数量。

	`dy:Number` — 将 Rectangle 对象的 y 值移动此数量。

另请参见

使用 Rectangle 对象

offsetPoint

()

方法

public function offsetPoint(point:Point):void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

将 Point 对象用作参数来调整 Rectangle 对象的位置。此方法与 Rectangle.offset() 方法类似，只不过它采用 Point 对象作为参数。

参数

point:Point — 要用于偏移此 Rectangle 对象的 Point 对象。

另请参见

flash.geom.Point
使用 Rectangle 对象

setEmpty

()

方法

public function setEmpty():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

将 Rectangle 对象的所有属性设置为 0。如果 Rectangle 对象的宽度或高度小于或等于 0，则该对象为空。

此方法将 x、y、width 和 height 属性设置为 0。

另请参见

x
y
width
height

toString

()

方法

public function toString():String

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

生成并返回一个字符串，该字符串列出 Rectangle 对象的水平位置和垂直位置以及高度和宽度。

String — 一个字符串，它列出了 Rectangle 对象的下列各个属性的值：x、y、width 和 height。

另请参见

x
y
width
height

union

()

方法

public function union(toUnion:Rectangle):Rectangle

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

通过填充两个矩形之间的水平和垂直空间，将这两个矩形组合在一起以创建一个新的 Rectangle 对象。

参数

toUnion:Rectangle — 要添加到此 Rectangle 对象的 Rectangle 对象。

Rectangle — 充当两个矩形的联合的新 Rectangle 对象。

另请参见

使用 Rectangle 对象

示例如何使用示例

下面的示例使用 RectangleExample 类以不同的高度和宽度在不同的 x , y 坐标处创建三个新的 Rectangle 对象，随后使用 trace() 方法确认是否成功创建了 Rectangle 实例。然后将布尔变量 isContained 赋予对 containsRect() 方法的调用结果，该方法确定第二个矩形未完全包含第三个矩形。

package {
    import flash.display.Sprite;
    import flash.geom.Rectangle;

    public class RectangleExample extends Sprite {

        public function RectangleExample() {
            var firstRect:Rectangle = new Rectangle();
            trace(firstRect);  // (x=0, y=0, w=0, h=0)
            var secondRect:Rectangle = new Rectangle(1, 3, 11, 13);
            trace(secondRect); // (x=1, y=3, w=11, h=13)
            var thirdRect:Rectangle = new Rectangle(5, 8, 17, 19);
            trace(thirdRect);  // (x=5, y=8, w=17, h=19)
            var isContained:Boolean = secondRect.containsRect(thirdRect);
            trace(isContained); // false
        }
    }
}

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/flash/geom/Rectangle.html

ActionScript 3.0 语言和组件参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 帧无帧
Rectangle	属性 \| 方法 \| 示例

包	flash.geom
类	public class Rectangle
继承	Rectangle Object