window.runtime 属性window.runtime.flash.geom.Point
继承Point Inheritance Object

Point 对象表示二维坐标系统中的某个位置，其中 x 表示水平轴，y 表示垂直轴。

下面的代码在 (0,0) 处创建一个点：

var myPoint:Point = new Point();
var myPoint = new Point();

以下类的方法和属性使用 Point 对象：

您可以使用 new Point() 构造函数创建 Point 对象。

查看示例

另请参见

BitmapData
Matrix
NativeWindow
Rectangle
Using Point objects

属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  length : Number
[只读 (read-only)] 从 (0,0) 到此点的线段长度。
Point
 Inheritedprototype : 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
 Inherited
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
  
interpolate(pt1:Point, pt2:Point, f:Number):Point
[静态] 确定两个指定点之间的点。
Point
 Inherited
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
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
  
subtract(v:Point):Point
从此点的坐标中减去另一个点的坐标以创建一个新点。
Point
  
toString():String
返回包含 x 和 y 坐标的值的字符串。
Point
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
属性详细信息
length属性
length:Number  [只读 (read-only)]

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

另请参见

Point.polar()
x属性 
var x:Number

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

另请参见

Using Point objects
y属性 
var y:Number

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

另请参见

Using Point objects
构造函数详细信息
Point()构造函数
function Point(x:Number = 0, y:Number = 0)

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

参数
x:Number (default = 0) — 水平坐标。
 
y:Number (default = 0) — 垂直坐标。
方法详细信息
add()方法
function add(v:Point):Point

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

参数

v:Point — 要添加的点。

返回
Point — 新点。
clone()方法 
function clone():Point

创建此 Point 对象的副本。

返回
Point — 新的 Point 对象。
distance()方法 
function distance(pt1:Point, pt2:Point):Number

返回 pt1 和 pt2 之间的距离。

参数

pt1:Point — 第一个点。
 
pt2:Point — 第二个点。

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

另请参见

Using Point objects
equals()方法 
function equals(toCompare:Point):Boolean

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

参数

toCompare:Point — 要比较的点。

返回
Boolean — 如果该对象与此 Point 对象相同，则为 true 值，如果不相同，则为 false。
interpolate()方法 
function interpolate(pt1:Point, pt2:Point, f:Number):Point

确定两个指定点之间的点。参数 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()方法 
function normalize(thickness:Number):void

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

参数

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

另请参见

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

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

参数

dx:Number — 水平坐标 x 的偏移量。
 
dy:Number — 垂直坐标 y 的偏移量。

polar()方法 
function polar(len:Number, angle:Number):Point

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

参数

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

返回
Point — 笛卡尔点。

另请参见

length

Using Point objects
subtract()方法 
function subtract(v:Point):Point

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

参数

v:Point — 要减去的点。

返回
Point — 新点。
toString()方法 
function toString():String

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

返回
String — 坐标的字符串表示形式。
示例
PointExample.as

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

注意：要测试此示例，请执行以下操作：

  1. 将 AIRAliases.js 文件添加到项目目录。
  2. 为该项目创建应用程序描述符文件，并使用 ADL 测试该项目。
<html>
    <head>
      <script src="AIRAliases.js" />
      <script>
        function init() {
        var point1 = new air.Point();
        air.trace(point1);  // (x=0, y=0)
        
        var point2 = new air.Point(6, 8);
        air.trace(point2); // (x=6, y=8)
        
        air.trace(air.Point.interpolate(point1, point2, 0.5)); // (x=3, y=4)
        
        air.trace(air.Point.distance(point1, point2)); // 10
        
        air.trace(point1.add(point2)); // (x=6, y=8)
        
        var point3 = point2.clone();
        air.trace(point2.equals(point3)); // true
        
        point3.normalize(2.5);
        air.trace(point3); // (x=1.5, y=2)
        
        air.trace(point2.subtract(point3)); // (x=4.5, y=6)
        
        air.trace(point1.offset(2, 3)); // 
        
        var angle = Math.PI * 2 * (30 / 360); // 30°
        air.trace(air.Point.polar(4, angle)) // (x=3.464101615137755, y=1.9999999999999998)   
        }
      </script>
    </head>
    <body onload='init()'>
    </body>
</html>



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Wed Aug 27 2008, 07:01 AM -07:00