1、Flash ActionScript 3.0 语言和组件参考(Point)第 1 页 共 8 页包 flash.geom类 public class Point继承 Point Object语言版本: ActionScript 3.0产品版本: Lite 2.0运行时版本: AIR 1.0, Flash Player 9Point 对象表示二维坐标系统中的某个位置,其中 x 表示水平轴, y 表示垂直轴。 下面的代码在 (0,0) 处创建一个点:var myPoint:Point = new Point();以下类的方法和属性使用 Point 对象: BitmapData DisplayObj
2、ect DisplayObjectContainer DisplacementMapFilter Matrix Rectangle 您可以使用 new Point() 构造函数创建 Point 对象。查看示例另请参见flash.display.BitmapDataflash.display.DisplayObjectflash.display.DisplayObjectContainerflash.filters.DisplacementMapFilterflash.geom.Matrixflash.geom.Rectangle公共属性隐藏继承的公共属性显示继承的公共属性属性 定义方const
3、ructor : Object 对类对象或给定对象实例的构造函数的引用。 Objectlength : Number PointFlash ActionScript 3.0 语言和组件参考(Point)第 2 页 共 8 页只读 (read-only) 从 (0,0) 到此点的线段长度。prototype : Object 静态 对类或函数对象的原型对象的引用。 Objectx : Number 该点的水平坐标。 Pointy : Number 该点的垂直坐标。 Point公共方法 隐藏继承的公共方法显示继承的公共方法方法 定义方Point(x:Number = 0, y:Number = 0
4、)创建一个新点。 Pointadd(v:Point):Point将另一个点的坐标添加到此点的坐标以创建一个新点。 Pointclone():Point创建此 Point 对象的副本。 Pointdistance(pt1:Point, pt2:Point):Number静态 返回 pt1 和 pt2 之间的距离。 Pointequals(toCompare:Point):Boolean确定两个点是否相同。 PointhasOwnProperty(name:String):Boolean指示对象是否已经定义了指定的属性。 Objectinterpolate(pt1:Point, pt2:Point
5、, f:Number):Point静态 确定两个指定点之间的点。 PointisPrototypeOf(theClass:Object):Boolean指示 Object 类的实例是否在指定为参数的对象的原型链中。 Objectnormalize(thickness:Number):void将 (0,0) 和当前点之间的线段缩放为设定的长度。 Pointoffset(dx:Number, dy:Number):void按指定量偏移 Point 对象。 Pointpolar(len:Number, angle:Number):Point静态 将一对极坐标转换为笛卡尔点坐标。 Pointprope
6、rtyIsEnumerable(name:String):Boolean指示指定的属性是否存在、是否可枚举。 ObjectsetPropertyIsEnumerable(name:String, isEnum:Boolean = true):void设置循环操作动态属性的可用性。Objectsubtract(v:Point):Point PointFlash ActionScript 3.0 语言和组件参考(Point)第 3 页 共 8 页从此点的坐标中减去另一个点的坐标以创建一个新点。toString():String返回包含 x 和 y 坐标的值的字符串。 PointvalueOf():
7、Object返回指定对象的原始值。 Object属性详细信息length属性length:Number 只读 (read-only) 语言版本: ActionScript 3.0产品版本: Lite 2.0运行时版本: AIR 1.0, Flash Player 9从 (0,0) 到此点的线段长度。 实现 public function get length():Number另请参见Point.polar()x属性 public var x:Number 语言版本: ActionScript 3.0产品版本: Lite 2.0运行时版本: AIR 1.0, Flash Player 9该点的水
8、平坐标。 默认值为 0。 y属性 public var y:Number 语言版本: ActionScript 3.0产品版本: Lite 2.0运行时版本: AIR 1.0, Flash Player 9该点的垂直坐标。 默认值为 0。 构造函数详细信息Point()构造函数public function Point(x:Number = 0, y:Number = 0) 语言版本: ActionScript 3.0产品版本: Lite 2.0运行时版本: AIR 1.0, Flash Player 9Flash ActionScript 3.0 语言和组件参考(Point)第 4 页 共
9、8 页创建一个新点。 如果不向此方法传递任何参数,则在 (0,0) 处创建一个点。 参数 x:Number (default = 0) 水平坐标。 y:Number (default = 0) 垂直坐标。 方法详细信息add()方法public function add(v:Point):Point 语言版本: ActionScript 3.0产品版本: Lite 2.0运行时版本: AIR 1.0, Flash Player 9将另一个点的坐标添加到此点的坐标以创建一个新点。 参数 v:Point 要添加的点。 返回 Point 新点。 clone() 方法 public function
10、clone():Point 语言版本: ActionScript 3.0产品版本: Lite 2.0运行时版本: AIR 1.0, Flash Player 9创建此 Point 对象的副本。 返回 Point 新的 Point 对象。 distance() 方法 public static function distance(pt1:Point, pt2:Point):Number 语言版本: ActionScript 3.0运行时版本: AIR 1.0, Flash Player 9返回 pt1 和 pt2 之间的距离。 参数 pt1:Point 第一个点。 pt2:Point 第二个点。
11、 返回 Number 第一个点和第二个点之间的距离。 equals() 方法 Flash ActionScript 3.0 语言和组件参考(Point)第 5 页 共 8 页public function equals(toCompare:Point):Boolean 语言版本: ActionScript 3.0运行时版本: AIR 1.0, Flash Player 9确定两个点是否相同。 如果两个点具有相同的 x 和 y 值,则它们是相同的点。 参数 toCompare:Point 要比较的点。 返回 Boolean 如果该对象与此 Point 对象相同,则为 true 值,如果不相同,则
12、为 false。 interpolate() 方法 public static function interpolate(pt1:Point, pt2:Point, f:Number):Point 语言版本: ActionScript 3.0产品版本: Lite 2.0运行时版本: AIR 1.0, Flash Player 9确定两个指定点之间的点。 参数 f 确定新的内插点相对于参数 pt1 和 pt2 指定的两个端点所处的位置。 参数 f 的值越接近 1.0,则内插点就越接近第一个点(参数 pt1)。 参数 f 的值越接近 0,则内插点就越接近第二个点(参数 pt2)。 参数 pt1:P
13、oint 第一个点。 pt2:Point 第二个点。 f:Number 两个点之间的内插级别。 指示新点将位于 pt1 和 pt2 连成的直线上的什么位置。 如果 f=1,则返回 pt1;如果 f=0,则返回 pt2。 返回 Point 新的内插点。 normalize() 方法 public function normalize(thickness:Number):void 语言版本: ActionScript 3.0产品版本: Lite 2.0运行时版本: AIR 1.0, Flash Player 9将 (0,0) 和当前点之间的线段缩放为设定的长度。 参数 thickness:Numb
14、er 缩放值。 例如,如果当前点为 (0,5) 并且您将它规范化为 1,则返回的点位于 (0,1) 处。 Flash ActionScript 3.0 语言和组件参考(Point)第 6 页 共 8 页另请参见lengthoffset()方法 public function offset(dx:Number, dy:Number):void 语言版本: ActionScript 3.0运行时版本: AIR 1.0, Flash Player 9按指定量偏移 Point 对象。 dx 的值将添加到 x 的原始值中以创建新的 x 值。 dy 的值将添加到 y 的原始值中以创建新的 y 值。 参数
15、dx:Number 水平坐标 x 的偏移量。 dy:Number 垂直坐标 y 的偏移量。 polar() 方法 public static function polar(len:Number, angle:Number):Point 语言版本: ActionScript 3.0产品版本: Lite 2.0运行时版本: AIR 1.0, Flash Player 9将一对极坐标转换为笛卡尔点坐标。 参数 len:Number 极坐标对的长度。 angle:Number 极坐标对的角度(以弧度表示)。 返回 Point 笛卡尔点。 另请参见lengthMath.round()subtract()
16、方法 public function subtract(v:Point):Point 语言版本: ActionScript 3.0产品版本: Lite 2.0运行时版本: AIR 1.0, Flash Player 9从此点的坐标中减去另一个点的坐标以创建一个新点。 参数 Flash ActionScript 3.0 语言和组件参考(Point)第 7 页 共 8 页v:Point 要减去的点。 返回 Point 新点。 toString() 方法 public function toString():String 语言版本: ActionScript 3.0运行时版本: AIR 1.0, F
17、lash Player 9返回包含 x 和 y 坐标的值的字符串。 该字符串的格式为 “(x= x, y=y)“,因此为点 23,17 调用 toString() 方法将返回 “(x=23, y=17)“。 返回 String 坐标的字符串表示形式。 示例 如何使用示例 下面的示例使用 PointExample 类在不同的 x,y 坐标处创建多个新 Point 对象,然后使用 trace() 方法输出各种类方法的结果。 package import flash.display.Sprite;import flash.geom.Point;public class PointExample ex
18、tends Sprite public function PointExample() var point1:Point = new Point();trace(point1); / (x=0, y=0)var point2:Point = new Point(6, 8);trace(point2); / (x=6, y=8)trace(Point.interpolate(point1, point2, 0.5); / (x=3, y=4)trace(Point.distance(point1, point2); / 10trace(point1.add(point2); / (x=6, y=
19、8)var point3:Point = point2.clone();trace(point2.equals(point3); / truepoint3.normalize(2.5);trace(point3); / (x=1.5, y=2)trace(point2.subtract(point3); / (x=4.5, y=6)Flash ActionScript 3.0 语言和组件参考(Point)第 8 页 共 8 页trace(point1.offset(2, 3); / var angle:Number = Math.PI * 2 * (30 / 360); / 30trace(Point.polar(4, angle) / (x=3.464101615137755, y=1.9999999999999998) 2004-2008 Adobe Systems Incorporated. All rights reserved. Sun Oct 26 2008, 02:41 AM -07:00