Rectangle 表示矩形區域的物件

Rectangle 類別具有 x, y 及 width, height 屬性可表示矩形的座標及區域範圍，這可以說是一個抽象的數據，不是真實畫出一個矩形。具有多種實用的方法，判斷是否進入某區域、擴大區域範圍等。許多其它的類別需要運用到矩形區域 Rectangle 物件來處理。

Rectangle 類別與物件 - flash.geom 套件

建構 Rectangle 物件

import flash.geom.Rectangle;
var rect:Rectangle = new Rectangle(0,0,200,100);

建構函式 Rectangle()

• 建立具有 x, y 座標及 width, height 屬性的矩形區域物件，僅以像素為單位。
• public function Rectangle(x:Number=0, y:Number=0, width:Number=0, height:Number=0)
  • x:矩形區域左上角橫座標，預設值 0 。
  • y:矩形區域左上角縱座標，預設值 0 。
  • width:矩形區域的寬度，預設值 0 。
  • height:矩形區域的高度，預設值 0 。

Rectangle 的屬性與方法

Rectangle 繼承 Object

[屬性]

x

• 指出矩形區域左上角的橫座標，以所在的容器物件為左上角為 0 。
• public var x:Number [讀寫]，單位為像素。
• rt.x=50 //指定 rt 矩形物件左上角的 x 座標為 50 像素。

y

• 指出矩形區域左上角的縱座標，以所在的容器物件為左上角為 0 。
• public var y:Number [讀寫]，單位為像素。
• rt.y=50 //指定 rt 矩形物件左上角的 y 座標為 50 像素。

height

• 指出矩形區域的高度。
• public var height:Number [讀寫]，單位為像素。
• rt.height=100 //指定 rt 矩形物件高度為 100 像素。

width

• 指出矩形區域的寬度。
• public var width:Number [讀寫]，單位為像素。
• rt.width=100 //指定 rt 矩形物件寬度為 100 像素。

[方法]

contains()

• 判斷矩形區域是否涵蓋參數 x, y 所指定的座標位置。
• public function contains(x:Number, y:Number):Boolean
• if(rt.contains(50,50)) //判斷 (50,50) 座標位置是否在 rt 矩形物件區域內。

containsPoint()

• 判斷矩形區域是否涵蓋參數 point 物件所指定的座標位置。
• public function containsPoint(point:Point):Boolean
• if(rt.containsPoint(pt)) //判斷 pt 物件指定的座標位置是否在 rt 矩形物件區域內。

containsRect()

• 判斷矩形區域是否涵蓋參數 rect 矩形物件所指定的區域。
• public function containsRect(rect:Rectangle):Boolean
• if(rt.containsRect(a)) //判斷 a 矩形物件指定的區域是否完全在 rt 矩形物件區域內。

intersects()

• 判斷矩形區域是否與參數 toIntersect 矩形物件有相交 (重疊) 的區域。
• public function intersects(toIntersect:Rectangle):Boolean
• if(rt.intersects(a)) //判斷 a 矩形物件指定的區域是否有與 rt 矩形物件區域相交。

equals()

• 判斷矩形區域是否與參數 toCompare 矩形物件為完全相同的區域。
• public function equals(toCompare:Rectangle):Boolean
• if(rt.equals(a)) //判斷 a 矩形物件指定的區域是否有與 rt 矩形物件區域相同。

inflate()

• 由矩形中心點左右各加寬參數 dx/2 像素、上下各加高參數 dy/2 像素；矩形中心點位置不變。
• public function inflate(dx:Number, dy:Number):void
• rt.inflate(10,20) //指定 rt 矩形物件左右各增加 5 像素、上下各增加 10 像素。

inflatePoint()

• 由矩形中心點左右各加寬參數 point 屬性 x/2 像素、上下各加高參數 point 屬性 y/2 像素；矩形中心點位置不變。
• public function inflatePoint(point:Point):void
• rt.inflatePoint(pt) //指定 rt 矩形物件左右各增加 pt.x/2 像素、上下各增加 pt.y/2 像素。

intersection()

• 產生矩形物件與參數 toIntersect 矩形物件的交集 (重疊) 區域。
• public function intersection(toIntersect:Rectangle):Rectangle
• inter=rt.intersection(a) //將 rt 與 a 矩形物件相交的矩形區域指定給 inter 物件。

isEmpty()

• 判斷矩形物件區域是否為空區域 (width<=0 或 height<=0) 。
• public function isEmpty():Boolean
• if(rt.isEmpty()) //判斷 rt 矩形物件是否為零區域。