flash actionscript30 Rectangle.docx
《flash actionscript30 Rectangle.docx》由会员分享，可在线阅读，更多相关《flash actionscript30 Rectangle.docx（27页珍藏版）》请在冰豆网上搜索。
flashactionscript30Rectangle
包
flash.geom
类
publicclassRectangle
继承
Rectangle
Object
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
Rectangle对象是按其位置（由它左上角的点（x,y）确定）以及宽度和高度定义的区域。
Rectangle类的x、y、width和height属性相互独立；更改一个属性的值不会影响其它属性。
但是，right和bottom属性与这四个属性是整体相关的。
例如，如果更改right属性的值，则width属性的值将发生变化；如果更改bottom属性，则height属性的值将发生变化。
以下方法和属性使用Rectangle对象：
∙applyFilter（）、colorTransform（）、copyChannel（）、copyPixels（）、draw（）、fillRect（）、generateFilterRect（）、getColorBoundsRect（）、getPixels（）、merge（）、paletteMap（）、pixelDisolve（）、setPixels（）和threshold（）方法，以及BitmapData类的rect属性
∙getBounds（）和getRect（）方法，以及DisplayObject类的scrollRect和scale9Grid属性
∙TextField类的getCharBoundaries（）方法
∙Transform类的pixelBounds属性
∙Sprite类的startDrag（）方法的bounds参数
∙PrintJob类的addPage（）方法的printArea参数
您可以使用newRectangle（）构造函数创建Rectangle对象。
注意：
Rectangle类不定义矩形Shape显示对象。
若要在屏幕上绘制矩形Shape对象，请使用Graphics类的drawRect（）方法。
查看示例
另请参见
flash.display.DisplayObject.scrollRect
flash.display.BitmapData
flash.display.DisplayObject
flash.text.TextField.getCharBoundaries（）
flash.geom.Transform.pixelBounds
flash.display.Sprite.startDrag（）
flash.printing.PrintJob.addPage（）
公共属性
隐藏继承的公共属性
显示继承的公共属性
属性
定义方
bottom:
Number
y和height属性的和。
Rectangle
bottomRight:
Point
由right和bottom属性的值确定的Rectangle对象的右下角的位置。
Rectangle
constructor:
Object
对类对象或给定对象实例的构造函数的引用。
Object
height:
Number
矩形的高度（以像素为单位）。
Rectangle
left:
Number
矩形左上角的x坐标。
Rectangle
prototype:
Object
[静态]对类或函数对象的原型对象的引用。
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 [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
y和height属性的和。
实现
publicfunctiongetbottom（）:
Number
publicfunctionsetbottom（value:
Number）:
void
另请参见
y
height
bottomRight
属性
bottomRight:
Point [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
由right和bottom属性的值确定的Rectangle对象的右下角的位置。
实现
publicfunctiongetbottomRight（）:
Point
publicfunctionsetbottomRight（value:
Point）:
void
另请参见
flash.geom.Point
height
属性
publicvarheight:
Number
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
矩形的高度（以像素为单位）。
更改Rectangle对象的height值对x、y和width属性没有影响。
另请参见
x
y
height
left
属性
left:
Number [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
矩形左上角的x坐标。
更改Rectangle对象的left属性对y和height属性没有影响。
但是，它会影响width属性，而更改x值不会影响width属性。
left属性的值等于x属性的值。
实现
publicfunctiongetleft（）:
Number
publicfunctionsetleft（value:
Number）:
void
另请参见
x
y
width
height
right
属性
right:
Number [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
x和width属性的和。
实现
publicfunctiongetright（）:
Number
publicfunctionsetright（value:
Number）:
void
另请参见
x
width
size
属性
size:
Point [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
Rectangle对象的大小，该对象表示为具有width和height属性的值的Point对象。
实现
publicfunctiongetsize（）:
Point
publicfunctionsetsize（value:
Point）:
void
另请参见
flash.geom.Point
top
属性
top:
Number [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
矩形左上角的y坐标。
更改Rectangle对象的top属性对x和width属性没有影响。
但是，它会影响height属性，而更改y值不会影响height属性。
top属性的值等于y属性的值。
实现
publicfunctiongettop（）:
Number
publicfunctionsettop（value:
Number）:
void
另请参见
x
y
width
height
topLeft
属性
topLeft:
Point [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
由该点的x和y坐标确定的Rectangle对象左上角的位置。
实现
publicfunctiongettopLeft（）:
Point
publicfunctionsettopLeft（value:
Point）:
void
另请参见
flash.geom.Point
x
y
width
属性
publicvarwidth:
Number
运行时版本:
AIR1.0,FlashPlayer9
矩形的宽度（以像素为单位）。
更改Rectangle对象的width值对x、y和height属性没有影响。
另请参见
x
y
height
x
属性
publicvarx:
Number
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
矩形左上角的x坐标。
更改Rectangle对象的x属性的值对y、width和height属性没有影响。
x属性的值等于left属性的值。
另请参见
left
y
属性
publicvary:
Number
运行时版本:
AIR1.0,FlashPlayer9
矩形左上角的y坐标。
更改Rectangle对象的y属性的值对x、width和height属性没有影响。
y属性的值等于top属性的值。
另请参见
x
width
height
top
构造函数详细信息
Rectangle
（）
构造函数
publicfunctionRectangle（x:
Number=0,y:
Number=0,width:
Number=0,height:
Number=0）
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
创建一个新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
（）
方法
publicfunctionclone（）:
Rectangle
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
返回一个新的Rectangle对象，其x、y、width和height属性的值与原始Rectangle对象的对应值相同。
返回
Rectangle—新的Rectangle对象，其x、y、width和height属性的值与原始Rectangle对象的对应值相同。
另请参见
x
y
width
height
contains
（）
方法
publicfunctioncontains（x:
Number,y:
Number）:
Boolean
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
确定由此Rectangle对象定义的矩形区域内是否包含指定的点。
参数
x:
Number—点的x坐标（水平位置）。
y:
Number—点的y坐标（垂直位置）。
返回
Boolean—如果Rectangle对象包含指定的点，则值为true；否则为false。
另请参见
flash.geom.Point
containsPoint
（）
方法
publicfunctioncontainsPoint（point:
Point）:
Boolean
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
确定由此Rectangle对象定义的矩形区域内是否包含指定的点。
此方法与Rectangle.contains（）方法类似，只不过它采用Point对象作为参数。
参数
point:
Point—用其x和y坐标表示的点。
返回
Boolean—如果Rectangle对象包含指定的点，则值为true；否则为false。
另请参见
contains（）
flash.geom.Point
containsRect
（）
方法
publicfunctioncontainsRect（rect:
Rectangle）:
Boolean
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
确定此Rectangle对象内是否包含由rect参数指定的Rectangle对象。
如果一个Rectangle对象完全在另一个Rectangle的边界内，我们说第二个Rectangle包含第一个Rectangle。
参数
rect:
Rectangle—所检查的Rectangle对象。
返回
Boolean—如果此Rectangle对象包含您指定的Rectangle对象，则返回true值，否则返回false。
equals
（）
方法
publicfunctionequals（toCompare:
Rectangle）:
Boolean
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
确定在toCompare参数中指定的对象是否等于此Rectangle对象。
此方法将某个对象的x、y、width和height属性与此Rectangle对象所对应的相同属性进行比较。
参数
toCompare:
Rectangle—要与此Rectangle对象进行比较的矩形。
返回
Boolean—如果对象具有与此Rectangle对象完全相同的x、y、width和height属性值，则返回true值，否则返回false。
另请参见
x
y
width
height
inflate
（）
方法
publicfunctioninflate（dx:
Number,dy:
Number）:
void
语言版本:
ActionScript3.0
运行时版本:
FlashPlayer9,FlashPlayer9
按指定量增加Rectangle对象的大小（以像素为单位）。
保持Rectangle对象的中心点不变，使用dx值横向增加它的大小，使用dy值纵向增加它的大小。
参数
dx:
Number—Rectangle对象横向增加的值。
下列等式用于计算矩形的新宽度和位置：
x-=dx;
width+=2*dx;
dy:
Number—Rectangle纵向增加的值。
下列等式用于计算矩形的新高度和位置：
y-=dy;
height+=2*dy;
另请参见
x
y
inflatePoint
（）
方法
publicfunctioninflatePoint（point:
Point）:
void
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
增加Rectangle对象的大小。
此方法与Rectangle.inflate（）方法类似，只不过它采用Point
升级会员 