適用於 Adobe® Flash® Platform 的 ActionScript® 3.0 參考
首頁  |  隱藏套件和類別清單 |  套件  |  類別  |  新增內容  |  索引  |  附錄  |  為什麼顯示英文?
篩選: AIR 30.0 和更早版本, Flash Player 30.0 和更早版本, Flash Lite 4
Flex 4.6 和更早版本, Flash Pro CS6 和更早版本
隱藏篩選
flash.geom 

Rectangle  - AS3

套件x

最上層
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

語言元素

全域常數
全域函數
運算子
陳述式、關鍵字和指令
特殊類型

附錄

新增內容
編譯器錯誤
編譯器警告
執行階段錯誤
移轉至 ActionScript 3
支援的字元集
僅限 MXML 標籤
移動 XML 元素
Timed Text 標籤
不建議元素清單
AccessibilityImplementation 常數
如何使用 ActionScript 範例
法律聲明
套件flash.geom
類別public class Rectangle
繼承Rectangle Inheritance Object
子類別 RoundedRectangle

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

Rectangle 物件是由它的位置所定義的區域,並且是由它左上角的點 (x, y) 以及它的寬度及高度來表示。

Rectangle 類別的 xywidthheight 屬性都是互相獨立的,因此變更其中任何一個屬性的值並不會對其他屬性造成影響。 不過,rightbottom 屬性則與這四個屬性完全相關。 例如,如果變更了 right 屬性值,width 屬性值就會變更;如果變更了 bottom 屬性值,height 屬性值就會變更。

下列方法和屬性都會使用 Rectangle 物件:

  • BitmapData 類別的 applyFilter()colorTransform()copyChannel()copyPixels()draw()fillRect()generateFilterRect()getColorBoundsRect()getPixels()merge()paletteMap()pixelDisolve()setPixels()threshold() 方法以及 rect 屬性
  • DisplayObject 類別的 getBounds()getRect() 方法以及 scrollRectscale9Grid 屬性
  • TextField 類別的 getCharBoundaries() 方法
  • Transform 類別的 pixelBounds 屬性
  • Sprite 類別之 startDrag() 方法的 bounds 參數
  • PrintJob 類別之 addPage() 方法的 printArea 參數

您可以使用 new Rectangle() 建構函式來建立 Rectangle 物件。

注意:Rectangle 類別不會定義矩形的 Shape 顯示物件。 若要在畫面上繪製矩形 Shape 物件,請使用 Graphics 類別的 drawRect() 方法。

檢視範例

相關 API 元素



公用屬性
 屬性定義自
  bottom : Number
y 和 height 屬性的總和。
Rectangle
  bottomRight : Point
Rectangle 物件右下角的位置,這個位置會以 right 和 bottom 屬性值來決定。
Rectangle
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
  height : Number
矩形的高度,以像素為單位。
Rectangle
  left : Number
矩形左上角的 x 座標。
Rectangle
  right : Number
x 和 width 屬性的總和。
Rectangle
  size : Point
Rectangle 物件的大小,以 Point 物件的 width 和 height 屬性值來表示。
Rectangle
  top : Number
矩形左上角的 y 座標。
Rectangle
  topLeft : Point
Rectangle 物件左上角的位置,這個位置會以該點的 x 及 y 值來決定。
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)
會使用 x 和 y 參數指定之左上角以及指定的寬度和高度,建立新的 Rectangle 物件。
Rectangle
  
傳回新的 Rectangle 物件,該物件具有與原始 Rectangle 物件相同的 x、y、width 和 height 屬性值。
Rectangle
  
決定指定的點是否包含在此 Rectangle 物件所定義的矩形區域中。
Rectangle
  
決定指定的點是否包含在此 Rectangle 物件所定義的矩形區域中。
Rectangle
  
判斷 rect 參數指定的 Rectangle 物件是否包含在此 Rectangle 物件內。
Rectangle
  
copyFrom(sourceRect:Rectangle):void
將來源 Rectangle 物件中的所有矩形資料複製到呼叫的 Rectangle 物件。
Rectangle
  
判斷在 toCompare 參數中指定的物件是否等於此 Rectangle 物件。
Rectangle
 Inherited
指出物件是否有已定義的指定屬性。
Object
  
會以指定的量來增加 Rectangle 物件的大小 (以像素為單位)。
Rectangle
  
增加 Rectangle 物件的大小。
Rectangle
  
如果在 toIntersect 參數中指定的 Rectangle 物件與此 Rectangle 物件有交集,便以 Rectangle 物件的形式傳回交集區域。
Rectangle
  
判斷在 toIntersect 參數中指定的物件是否與此 Rectangle 物件有交集。
Rectangle
  
決定此 Rectangle 物件是否為空白。
Rectangle
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
  
依照指定的數量調整 Rectangle 物件的位置 (以它的左上角為準)。
Rectangle
  
使用 Point 物件做為參數來調整 Rectangle 物件的位置。
Rectangle
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
  
將 Rectangle 物件的所有屬性設為 0。
Rectangle
 Inherited
為迴圈作業設定動態屬性的可用性。
Object
  
setTo(xa:Number, ya:Number, widtha:Number, heighta:Number):void
將 Rectangle 的成員設定為指定值
Rectangle
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
  
建立並傳回一個字串,用來列出 Rectangle 物件的水平和垂直位置,以及寬度及高度。
Rectangle
  
透過同時新增兩個矩形,並且填滿兩個矩形之間的水平及垂直空間,建立新的 Rectangle 物件。
Rectangle
 Inherited
會傳回指定之物件的基本值。
Object
屬性詳細資訊

bottom

屬性
bottom:Number

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

yheight 屬性的總和。

顯示位置和度量屬性的矩形影像。



實作
    public function get bottom():Number
    public function set bottom(value:Number):void

相關 API 元素

bottomRight

屬性 
bottomRight:Point

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

Rectangle 物件右下角的位置,這個位置會以 rightbottom 屬性值來決定。

顯示位置和度量屬性的矩形影像。



實作
    public function get bottomRight():Point
    public function set bottomRight(value:Point):void

相關 API 元素

height

屬性 
public var height:Number

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

矩形的高度,以像素為單位。 變更 Rectangle 物件的 height 值並不會對 xywidth 屬性造成影響。

顯示位置和度量屬性的矩形影像。

相關 API 元素

left

屬性 
left:Number

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

矩形左上角的 x 座標。 變更 Rectangle 物件的 left 屬性並不會對 yheight 屬性造成影響。 不過,這樣做會影響 width 屬性,而變更 x 值則不會影響 width 屬性。

left 屬性值等於 x 屬性值。

顯示位置和度量屬性的矩形影像。



實作
    public function get left():Number
    public function set left(value:Number):void

相關 API 元素

right

屬性 
right:Number

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

xwidth 屬性的總和。

顯示位置和度量屬性的矩形影像。



實作
    public function get right():Number
    public function set right(value:Number):void

相關 API 元素

size

屬性 
size:Point

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

Rectangle 物件的大小,以 Point 物件 (內含 widthheight 屬性的值) 來表示。



實作
    public function get size():Point
    public function set size(value:Point):void

相關 API 元素

top

屬性 
top:Number

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

矩形左上角的 y 座標。 變更 Rectangle 物件的 top 屬性並不會對 xwidth 屬性造成影響。 不過,這樣做會影響 height 屬性,而變更 y 值則不會影響 height 屬性。

top 屬性值等於 y 屬性值。

顯示位置和度量屬性的矩形影像。



實作
    public function get top():Number
    public function set top(value:Number):void

相關 API 元素

topLeft

屬性 
topLeft:Point

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

Rectangle 物件左上角的位置,這個位置會以該點的 xy 值來決定。

顯示位置和度量屬性的矩形影像。



實作
    public function get topLeft():Point
    public function set topLeft(value:Point):void

相關 API 元素

width

屬性 
public var width:Number

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

矩形的寬度,以像素為單位。 變更 Rectangle 物件的 width 值並不會對 xyheight 屬性造成影響。

顯示位置和度量屬性的矩形影像。

相關 API 元素

x

屬性 
public var x:Number

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

矩形左上角的 x 座標。 變更 Rectangle 物件的 x 屬性值並不會對 ywidthheight 屬性造成影響。

x 屬性值等於 left 屬性值。

相關 API 元素

y

屬性 
public var y:Number

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

矩形左上角的 y 座標。 變更 Rectangle 物件的 y 屬性值並不會對 xwidthheight 屬性造成影響。

y 屬性值等於 top 屬性值。

相關 API 元素

建構函式詳細資料

Rectangle

()建構函式
public function Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

會使用 xy 參數指定之左上角以及指定的 widthheight 參數,建立新的 Rectangle 物件。 如果您在呼叫這個函數時沒有使用參數,則會建立 xywidthheight 屬性都設為 0 的矩形。

參數
x:Number (default = 0) — 矩形左上角的 x 座標。
 
y:Number (default = 0) — 矩形左上角的 y 座標。
 
width:Number (default = 0) — 矩形的寬度,以像素為單位。
 
height:Number (default = 0) — 矩形的高度,以像素為單位。

相關 API 元素

方法詳細資訊

clone

()方法
public function clone():Rectangle

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

會傳回新的 Rectangle 物件,該物件具有與原始 Rectangle 物件相同的 xywidthheight 屬性值。

傳回值
Rectangle — 新的 Rectangle 物件,與原始 Rectangle 物件具有相同的 xywidthheight 屬性值。

相關 API 元素

contains

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

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

決定指定的點是否包含在此 Rectangle 物件所定義的矩形區域中。

參數

x:Number — 該點的 x 座標 (水平位置)。
 
y:Number — 該點的 y 座標 (垂直位置)。

傳回值
Boolean — 如果 Rectangle 物件包含指定的點,則值為 true,否則為 false

相關 API 元素

containsPoint

()方法 
public function containsPoint(point:Point):Boolean

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

決定指定的點是否包含在此 Rectangle 物件所定義的矩形區域中。 這個方法與 Rectangle.contains() 方法類似,不同點在於它會使用 Point 物件做為參數。

參數

point:Point — 以 xy 座標表示的點。

傳回值
Boolean — 如果 Rectangle 物件包含指定的點,則值為 true,否則為 false

相關 API 元素

containsRect

()方法 
public function containsRect(rect:Rectangle):Boolean

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

會決定 rect 參數指定的 Rectangle 物件是否包含在此 Rectangle 物件內。 如果第二個 Rectangle 物件完全位於第一個 Rectangle 物件的邊界裡,則可以說第一個 Rectangle 物件包含了第二個 Rectangle。

參數

rect:Rectangle — 要檢查的 Rectangle 物件。

傳回值
Boolean — 如果您指定的 Rectangle 物件包含在此 Rectangle 物件中,則值為 true,否則為 false

copyFrom

()方法 
public function copyFrom(sourceRect:Rectangle):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 11, AIR 3.0, Flash Lite 4

將來源 Rectangle 物件中的所有矩形資料複製到呼叫的 Rectangle 物件。

參數

sourceRect:Rectangle — 從其中複製資料的 Rectangle 物件。

equals

()方法 
public function equals(toCompare:Rectangle):Boolean

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

會決定在 toCompare 參數中指定的物件是否等於此 Rectangle 物件。 這個方法會將某個物件的 xywidthheight 屬性與此 Rectangle 物件的相同屬性進行比較。

參數

toCompare:Rectangle — 要與此 Rectangle 物件相比較的矩形。

傳回值
Boolean — 如果該物件的 xywidthheight 屬性值與此 Rectangle 物件完全相同,則值為 true,否則為 false

相關 API 元素

inflate

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

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Player 9, Flash Lite 4

會以指定的量來增加 Rectangle 物件的大小 (以像素為單位)。 Rectangle 物件的中心點將會維持不變,而它的大小則會向左方和右方增加 dx,並向上方和下方增加 dy

參數

dx:Number — Rectangle 物件向左方和右方所要增加的值。 下列方程式可用來計算矩形新的寬度和位置:
    x -= dx;
    width += 2 * dx;
    
 
dy:Number — Rectangle 物件向上方和下方所要增加的值。 下列方程式可用來計算矩形新的高度和位置:
    y -= dy;
    height += 2 * dy;
    

相關 API 元素

inflatePoint

()方法 
public function inflatePoint(point:Point):void

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

增加 Rectangle 物件的大小。 這個方法與 Rectangle.inflate() 方法類似,不同點在於它會使用 Point 物件做為參數。

以下兩段程式碼範例將會產生相同的結果:

     var rect1:Rectangle = new Rectangle(0,0,2,5);
     rect1.inflate(2,2)
     
     var rect1:Rectangle = new Rectangle(0,0,2,5);
     var pt1:Point = new Point(2,2);
     rect1.inflatePoint(pt1)
     

參數

point:Point — 這個 Point 物件的 x 屬性是用來增加 Rectangle 物件的水平尺寸; y 屬性則是用來增加 Rectangle 物件的垂直尺寸。

相關 API 元素

intersection

()方法 
public function intersection(toIntersect:Rectangle):Rectangle

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

如果在 toIntersect 參數中指定的 Rectangle 物件與此 Rectangle 物件有交集,便以 Rectangle 物件的形式傳回交集區域。 如果這些矩形沒有交集,這個方法會傳回空白的 Rectangle 物件,而且它的屬性都會設為 0。

產生的交集矩形。

參數

toIntersect:Rectangle — 要比較的 Rectangle 物件,以檢查它是否與此 Rectangle 物件有交集。

傳回值
Rectangle — 與交集區域相等的 Rectangle 物件。 如果這些矩形沒有交集,這個方法會傳回空白的 Rectangle 物件,也就是 xywidthheight 屬性都設為 0 的矩形。

intersects

()方法 
public function intersects(toIntersect:Rectangle):Boolean

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

會決定在 toIntersect 參數中指定的物件是否與此 Rectangle 物件交集。 這個方法會檢查指定之 Rectangle 物件的 xywidthheight 屬性,以查看它與這個 Rectangle 物件是否有交集。

參數

toIntersect:Rectangle — 要與此 Rectangle 物件比較的 Rectangle 物件。

傳回值
Boolean — 如果指定的物件與此 Rectangle 物件有交集,則值為 true,否則為 false

相關 API 元素

isEmpty

()方法 
public function isEmpty():Boolean

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

決定此 Rectangle 物件是否為空白。

傳回值
Boolean — 如果 Rectangle 物件的寬度或高度小於或等於 0,則值為 true,否則為 false

offset

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

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

依照指定的數量調整 Rectangle 物件的位置 (以它的左上角為準)。

參數

dx:Number — 會根據這個量來移動 Rectangle 物件的 x 值。
 
dy:Number — 會根據這個量來移動 Rectangle 物件的 y 值。

offsetPoint

()方法 
public function offsetPoint(point:Point):void

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

使用 Point 物件做為參數來調整 Rectangle 物件的位置。 這個方法與 Rectangle.offset() 方法類似,不同點在於它會使用 Point 物件做為參數。

參數

point:Point — 用來偏移此 Rectangle 物件的 Point 物件。

相關 API 元素

setEmpty

()方法 
public function setEmpty():void

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

將 Rectangle 物件的所有屬性設為 0。 如果 Rectangle 物件的寬度或高度小於或等於 0,則該物件為空白。

這個方法會將 xywidthheight 屬性的值都設為 0。

相關 API 元素

setTo

()方法 
public function setTo(xa:Number, ya:Number, widtha:Number, heighta:Number):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 11, AIR 3.0, Flash Lite 4

將 Rectangle 的成員設定為指定值

參數

xa:Number — 用來設定矩形的值。
 
ya:Number
 
widtha:Number
 
heighta:Number

toString

()方法 
public function toString():String

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

建立並傳回一個字串,用來列出 Rectangle 物件的水平和垂直位置,以及寬度及高度。

傳回值
String — 字串,其中列出 Rectangle 物件之下列各個屬性的值:xywidthheight

相關 API 元素

union

()方法 
public function union(toUnion:Rectangle):Rectangle

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

透過同時新增兩個矩形,並且填滿兩個矩形之間的水平及垂直空間,建立新的 Rectangle 物件。

產生的聯集矩形。

注意:union() 方法會忽略以 0 作為高度與寬度值的矩形,例如:var rect2:Rectangle = new Rectangle(300,300,50,0);

參數

toUnion:Rectangle — 要加入至此 Rectangle 物件的 Rectangle 物件。

傳回值
Rectangle — 聯集兩個矩形的新 Rectangle 物件。
RectangleExample.as

下列範例將使用 RectangleExample 類別在各個 xy 座標上建立三個具有不同高度和寬度的新 Rectangle 物件,然後使用 trace() 方法來確認已經成功建立 Rectangle 實體。 接著指定 Boolean 變數 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
        }
    }
}




[ X ]為什麼顯示英文?
「ActionScript 3.0 參考」的內容是以英文顯示

並非所有「ActionScript 3.0 參考」的內容都翻譯為所有語言。當語言元素未翻譯時,就會以英文顯示。例如,ga.controls.HelpBox 類別並沒有翻譯為任何語言。因此在參考的繁體中文版本中,ga.controls.HelpBox 類別就會以英文顯示。