flash.geom.Point (Flex 3.2)

	属性	定义方
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		length : Number [只读 (read-only)] 从 (0,0) 到此点的线段长度。	Point
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		x : Number 该点的水平坐标。	Point
		y : Number 该点的垂直坐标。	Point

	方法	定义方
		Point(x:Number = 0, y:Number = 0) 创建一个新点。	Point
		add(v:Point):Point 将另一个点的坐标添加到此点的坐标以创建一个新点。	Point
		clone():Point 创建此 Point 对象的副本。	Point
		distance(pt1:Point, pt2:Point):Number [静态] 返回 pt1 和 pt2 之间的距离。	Point
		equals(toCompare:Point):Boolean 确定两个点是否相同。	Point
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		interpolate(pt1:Point, pt2:Point, f:Number):Point [静态] 确定两个指定点之间的点。	Point
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		normalize(thickness:Number):void 将 (0,0) 和当前点之间的线段缩放为设定的长度。	Point
		offset(dx:Number, dy:Number):void 按指定量偏移 Point 对象。	Point
		polar(len:Number, angle:Number):Point [静态] 将一对极坐标转换为笛卡尔点坐标。	Point
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		subtract(v:Point):Point 从此点的坐标中减去另一个点的坐标以创建一个新点。	Point
		toString():String 返回包含 x 和 y 坐标的值的字符串。	Point
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

length

属性

length:Number [只读 (read-only)]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

从 (0,0) 到此点的线段长度。

实现
public function get length():Number

另请参见

Point.polar()

属性

public var x:Number

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

该点的水平坐标。默认值为 0。

另请参见

Using Point objects

属性

public var y:Number

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

该点的垂直坐标。默认值为 0。

另请参见

Using Point objects

构造函数详细信息

Point

()

构造函数

public function Point(x:Number = 0, y:Number = 0)

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

创建一个新点。如果不向此方法传递任何参数，则在 (0,0) 处创建一个点。

参数

	`x:Number` (default = `0`) — 水平坐标。

	`y:Number` (default = `0`) — 垂直坐标。

方法详细信息

add

()

方法

public function add(v:Point):Point

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

将另一个点的坐标添加到此点的坐标以创建一个新点。

参数

v:Point — 要添加的点。

Point — 新点。

clone

()

方法

public function clone():Point

语言版本:

ActionScript 3.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` — 第二个点。

Number — 第一个点和第二个点之间的距离。

另请参见

Using Point objects

equals

()

方法

public function equals(toCompare:Point):Boolean

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

确定两个点是否相同。如果两个点具有相同的 x 和 y 值，则它们是相同的点。

参数

toCompare:Point — 要比较的点。

Boolean — 如果该对象与此 Point 对象相同，则为 true 值，如果不相同，则为 false。

interpolate

()

方法

public static function interpolate(pt1:Point, pt2:Point, f:Number):Point

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

确定一个位于两个指定点之间的点。参数 f 确定新的内插点相对于参数 pt1 和 pt2 指定的两个端点所处的位置。参数 f 的值越接近 1.0，则内插点就越接近第一个点（参数 pt1）。参数 f 的值越接近 0，则内插点就越接近第二个点（参数 pt2）。

参数

	`pt1:Point` — 第一个点。

	`pt2:Point` — 第二个点。

	`f:Number` — 两个点之间的内插级别。指示新点将位于 `pt1` 和 `pt2` 连成的直线上的什么位置。如果 `f`=1，则返回 `pt1`；如果 `f`=0，则返回 `pt2`。

Point — 新的内插点。

normalize

()

方法

public function normalize(thickness:Number):void

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

将 (0,0) 和当前点之间的线段缩放为设定的长度。

参数

thickness:Number — 缩放值。例如，如果当前点为 (0,5) 并且您将它规范化为 1，则返回的点位于 (0,1) 处。

另请参见

length

offset

()

方法

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

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

按指定量偏移 Point 对象。dx 的值将添加到 x 的原始值中以创建新的 x 值。dy 的值将添加到 y 的原始值中以创建新的 y 值。

参数

	`dx:Number` — 水平坐标 x 的偏移量。

	`dy:Number` — 垂直坐标 y 的偏移量。

polar

()

方法

public static function polar(len:Number, angle:Number):Point

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

将一对极坐标转换为笛卡尔点坐标。

参数

	`len:Number` — 极坐标对的长度。

	`angle:Number` — 极坐标对的角度（以弧度表示）。

Point — 笛卡尔点。

另请参见

length
Math.round()
Using Point objects

subtract

()

方法

public function subtract(v:Point):Point

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

从此点的坐标中减去另一个点的坐标以创建一个新点。

参数

v:Point — 要减去的点。

Point — 新点。

toString

()

方法

public function toString():String

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 Flash Player 9

返回包含 x 和 y 坐标的值的字符串。该字符串的格式为 "(x=x, y=y)"，因此为点 23,17 调用 toString() 方法将返回 "(x=23, y=17)"。

String — 坐标的字符串表示形式。

示例如何使用示例

PointExample.as

下面的示例使用 PointExample 类在不同的 x,y 坐标处创建多个新 Point 对象，然后使用 trace() 方法输出各种类方法的结果。

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

    public class PointExample extends 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)); // 10
        
        trace(point1.add(point2)); // (x=6, y=8)
        
        var point3:Point = point2.clone();
        trace(point2.equals(point3)); // true
        
        point3.normalize(2.5);
        trace(point3); // (x=1.5, y=2)
        
        trace(point2.subtract(point3)); // (x=4.5, y=6)
        
        trace(point1.offset(2, 3)); // 
        
        var angle:Number = Math.PI * 2 * (30 / 360); // 30°
        trace(Point.polar(4, angle)) // (x=3.464101615137755, y=1.9999999999999998)   
        }
    }
}

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
Point	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例