fl.motion.Animator (ActionScript 3.0)

	属性	定义方
		autoRewind : Boolean = false 将动画设置为完成后重新开始播放。	Animator
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		isPlaying : Boolean [read-only] 指示动画当前是否正在播放。	Animator
		motion : Motion 包含动画的补间动画属性的对象。	Animator
		orientToPath : Boolean = false 沿运动路径设置显示对象的位置。	Animator
		positionMatrix : Matrix 将整体变形应用于运动路径的 Matrix 对象。	Animator
		prototype : Object [static] 对类或函数对象的原型对象的引用。	Object
		repeatCount : int = 1 动画的重复次数。	Animator
		target : DisplayObject 正呈现动画效果的显示对象。	Animator
		time : int 从零开始的整数，指示和控制当前动画中的时间。	Animator
		transformationPoint : Point 用于旋转或缩放显示对象的参考点。	Animator

	方法	定义方
		Animator(xml:XML = null, target:DisplayObject = null) 创建 Animator 对象，将基于 XML 的补间动画说明应用于显示对象。	Animator
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		end():void 停止播放动画，Flash Player 会立即转到动画序列中的最后一帧。	Animator
		fromXMLString(xmlString:String, target:DisplayObject = null):Animator [static] 基于 XML 字符串创建 Animator 对象。	Animator
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		nextFrame():void 使 Flash Player 前进到动画序列中的下一帧。	Animator
		pause():void 暂停动画，直到调用 resume() 方法。	Animator
		play():void 开始播放动画。	Animator
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		resume():void 在动画由 pause() 方法暂停后继续播放动画。	Animator
		rewind():void 将 Flash Player 设置到动画的第一帧。	Animator
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stop():void 停止播放动画，Flash Player 将返回到动画序列中的第一帧。	Animator
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

摘要	定义方
activate	Flash Player 获得操作系统焦点并变为活动状态时调度。	EventDispatcher
deactivate	Flash Player 失去操作系统焦点并变为非活动状态时调度。	EventDispatcher
motionEnd	在动画播放完成后调度，无论是播放到末尾还是由调用 stop() 或 end() 方法而中断动画。	Animator
motionStart	当动画开始播放时调度。	Animator
motionUpdate	当动画已更改并且屏幕已更新时调度。	Animator
timeChange	当 Animator 的 time 值已更改，但是屏幕尚未更新时（即 motionUpdate 事件）调度。	Animator

属性详细信息

autoRewind

属性

public var autoRewind:Boolean = false

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

将动画设置为完成后重新开始播放。

isPlaying

属性

isPlaying:Boolean [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

指示动画当前是否正在播放。

实现
public function get isPlaying():Boolean

motion

属性

motion:Motion [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

包含动画的补间动画属性的对象。

实现
public function get motion():Motion
public function set motion(value:Motion):void

orientToPath

属性

public var orientToPath:Boolean = false

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

沿运动路径设置显示对象的位置。如果设置为 true，则显示对象的基线会调整到运动路径的方向；否则，注册点会调整到运动路径的方向。

positionMatrix

属性

public var positionMatrix:Matrix

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

将整体变形应用于运动路径的 Matrix 对象。此矩阵允许在不更改显示对象外观的情况下移动、缩放、倾斜或旋转路径。

repeatCount

属性

public var repeatCount:int = 1

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

动画的重复次数。可能值为任何大于等于 0 的整数。值为 1 表示播放一次动画。值为 0 表示无限制地循环播放动画，直到被显式停止（例如，通过调用 end() 方法）。

默认值为 1.

另请参见

end()

target

属性

target:DisplayObject [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

正呈现动画效果的显示对象。可以使用 flash.display.DisplayObject 的任何子类，如 MovieClip、Sprite 或 Bitmap。

实现
public function get target():DisplayObject
public function set target(value:DisplayObject):void

另请参见

flash.display.DisplayObject

time

属性

time:int [read-write]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

从零开始的整数，指示和控制当前动画中的时间。在动画的第一帧，time 为 0。如果该动画的持续时间为 10 帧，则在最后一帧 time 为 9。

实现
public function get time():int
public function set time(value:int):void

transformationPoint

属性

public var transformationPoint:Point

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

用于旋转或缩放显示对象的参考点。变形点是相对于显示对象的边框的。变形点的坐标必须缩放到 1 x 1 像素的框中，其中 (1, 1) 代表对象的右下角，(0, 0) 代表对象的左上角。

构造函数详细信息

Animator

()

构造函数

public function Animator(xml:XML = null, target:DisplayObject = null)

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

创建 Animator 对象，将基于 XML 的补间动画说明应用于显示对象。

参数

	`xml:XML` (default = `null`) — 包含基于 XML 的补间动画说明的 E4X 对象。

	`target:DisplayObject` (default = `null`) — 使用补间动画的显示对象。

另请参见

Motion XML Elements

方法详细信息

end

()

方法

public function end():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

停止播放动画，Flash Player 会立即转到动画序列中的最后一帧。如果 autoRewind 属性设置为 true，则 Flash Player 会转到动画序列中的第一帧。

另请参见

autoRewind

fromXMLString

()

方法

public static function fromXMLString(xmlString:String, target:DisplayObject = null):Animator

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

基于 XML 字符串创建 Animator 对象。此方法是使用 Animator 构造函数的替代手段，它接受 E4X 对象。

参数

	`xmlString:String` — 描述补间动画的 XML 字符串。

	`target:DisplayObject` (default = `null`) — 使用补间动画的显示对象。

Animator — 将指定的 xmlString 应用于指定的 target 的 Animator 实例。

另请参见

Motion XML Elements

nextFrame

()

方法

public function nextFrame():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

使 Flash Player 前进到动画序列中的下一帧。

pause

()

方法

public function pause():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

暂停动画，直到调用 resume() 方法。

另请参见

resume()

play

()

方法

public function play():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

开始播放动画。在您调用 play() 方法之前先调用 end()，以确保在您开始新的动画实例之前以前的所有动画实例都已结束。

另请参见

end()

resume

()

方法

public function resume():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

在动画由 pause() 方法暂停后继续播放动画。

另请参见

pause()

rewind

()

方法

public function rewind():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

将 Flash Player 设置到动画的第一帧。如果动画正在播放，则它会从第一帧开始继续播放。如果动画已停止，则它会在第一帧位置保持停止状态。

stop

()

方法

public function stop():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

停止播放动画，Flash Player 将返回到动画序列中的第一帧。

另请参见

end()

事件详细信息

motionEnd

事件

事件对象类型: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_END

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

在动画播放完成后调度，无论是播放到末尾还是由调用 stop() 或 end() 方法而中断动画。

指示通过显式调用 Animator.stop() 或 Animator.end()，或者到达 Motion 实例的末尾，动画已结束。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 `myButton` 为 `currentTarget` 的值。
`target`	调度该事件的对象；它不一定是侦听该事件的对象。使用 `currentTarget` 属性始终可以访问侦听该事件的对象。

motionStart

事件

事件对象类型: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_START

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

当动画开始播放时调度。

指示 Motion 实例已经开始播放。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 `myButton` 为 `currentTarget` 的值。
`target`	调度该事件的对象；它不一定是侦听该事件的对象。使用 `currentTarget` 属性始终可以访问侦听该事件的对象。

motionUpdate

事件

事件对象类型: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_UPDATE

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

当动画已更改并且屏幕已更新时调度。

指示 Motion 实例已更改并且屏幕已更新。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 `myButton` 为 `currentTarget` 的值。
`target`	调度该事件的对象；它不一定是侦听该事件的对象。使用 `currentTarget` 属性始终可以访问侦听该事件的对象。

timeChange

事件

事件对象类型: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.TIME_CHANGE

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9.0.28.0

当 Animator 的 time 值已更改，但是屏幕尚未更新时（即 motionUpdate 事件）调度。

指示 Animator 实例的 time 值已更改，但是屏幕尚未更新（Flash Player 尚未调度 motionUpdate 事件）。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 `myButton` 为 `currentTarget` 的值。
`target`	调度该事件的对象；它不一定是侦听该事件的对象。使用 `currentTarget` 属性始终可以访问侦听该事件的对象。

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/fl/motion/Animator.html

ActionScript 3.0 语言和组件参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 帧无帧
Animator	属性 \| 方法 \| 事件

包	fl.motion
类	public class Animator
继承	Animator EventDispatcher Object