Animator

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

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

Animator 类将补间动画的 XML 说明应用于显示对象。Animator 类的属性和方法控制动画的播放，Flash Player 会广播事件以便对动画状态的变化做出响应。如果不存在任何三维内容，则 Flash CS4 中的“将动作复制为 ActionScript”命令将使用 Animator 类。对于三维内容，将改用 Animator3D 类，此类与 Animator 类共享相同的基类，但它专用于三维内容。然后，可以使用应用程序编程接口 (API) 编辑 ActionScript，或者制作您自己的自定义动画。

如果您要在函数中调用 Animator 类的方法，请在函数外声明 Animator 实例，以使对象的范围不只限于函数本身。如果在函数内声明实例，作为 Flash Player 例程“垃圾回收”的一部分，Flash Player 会在函数结束时删除 Animator 实例，目标对象将无法运行动画。

注意：在 Flash CS3 中，此类支持的某些属性和方法是此类独有的成员。Flash CS4 为此类的这些属性和方法引入了一个基类，即 AnimatorBase，现在，其他类可通过继承链共享这些属性和方法。如果您之前就已在使用 Flash CS3，请注意 Animator 类仍然支持这些属性和方法，但这些属性和方法在 Flash CS3 之后的 Flash Professional 版本中是 AnimatorBase 类的成员。对于此参考中的任何其他类，选择 Show Inherited Public Properties 和 Show Inherited Public 方法可查看该类支持的所有属性和方法。

默认 MXML 属性motion

相关 API 元素

Motion XML 元素

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		autoRewind : Boolean = false 将动画设置为完成后重新开始播放。	AnimatorBase
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		frameEvent : String Event.ENTER_FRAME 事件创建的事件对象的名称。	AnimatorBase
		initialPosition : Array [只写] 定义动画的起始位置的坐标数组。	AnimatorBase
		instanceFactoryClass : Class 使用 ActionScript 创建实例时，就是使用此类创建此实例。	AnimatorBase
		isPlaying : Boolean [只读] 指示动画当前是否正在播放。	AnimatorBase
		motion : MotionBase 包含动画的补间动画属性的对象。	AnimatorBase
		motionArray : Array 包含动画的补间动画属性的对象数组。	AnimatorBase
		orientToPath : Boolean = false 沿运动路径设置显示对象的位置。	AnimatorBase
		placeholderName : String 使用 ActionScript 创建实例时，这就是我们将替换的在舞台上显示的实例。	AnimatorBase
		positionMatrix : Matrix 将整体变形应用于运动路径的 Matrix 对象。	AnimatorBase
		repeatCount : int = 1 动画的重复次数。	AnimatorBase
		sceneName : String 导出的场景的参考（针对 3D 动画），以便将场景加载到父时间轴。	AnimatorBase
		spanEnd : int [只读] 返回结束目标动画的目标父级的帧。	AnimatorBase
		spanStart : int [只读] 返回开始目标动画的目标父级的帧。	AnimatorBase
		target : DisplayObject 正呈现动画效果的显示对象。	AnimatorBase
		targetName : String 依父级 DisplayObjectContainer 而定的目标对象的名称。	AnimatorBase
		targetParent : DisplayObjectContainer 将呈现动画效果的目标父级 DisplayObjectContainer，可以与 targetName 配合使用，以便在删除目标对象并在时间轴上将其替换后检索该目标对象。	AnimatorBase
		targetParentButton : SimpleButton	AnimatorBase
		targetState3D : Array 目标对象的初始方向。	AnimatorBase
		time : int 从零开始的整数，指示和控制当前动画中的时间。	AnimatorBase
		transformationPoint : Point 用于旋转或缩放显示对象的参考点。	AnimatorBase
		transformationPointZ : int 用于旋转或缩放显示对象的参考 Z 坐标点。	AnimatorBase
		usingCurrentFrame : Boolean [只读] 指示是否在进入新帧时检查 currentFrame 属性，以及是将目标的动画与其父级时间轴中的帧同步，还是不管父级的当前帧如何都始终进入。	AnimatorBase

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		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(reset:Boolean = false, stopEnterFrame:Boolean = true, pastLastFrame:Boolean = false):void 停止播放动画，Flash Player 会立即转到动画序列中的最后一帧。	AnimatorBase
		fromXMLString(xmlString:String, target:DisplayObject = null):Animator [静态] 基于 XML 字符串创建 Animator 对象。	Animator
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		matricesEqual(a:Matrix, b:Matrix):Boolean [静态] 比较指定为参数的两个母体，如果相等则返回 true。	Animator
		nextFrame(reset:Boolean = false, stopEnterFrame:Boolean = true):void 使 Flash Player 前进到动画序列中的下一帧。	AnimatorBase
		pause():void 暂停动画，直到调用 resume() 方法。	AnimatorBase
		play(startTime:int = -1, startEnterFrame:Boolean = true):void 开始播放动画。	AnimatorBase
		processCurrentFrame(parent:MovieClip, anim:AnimatorBase, startEnterFrame:Boolean, playOnly:Boolean = false):void [静态]	AnimatorBase
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		registerParentFrameHandler(parent:MovieClip, anim:AnimatorBase, spanStart:int, repeatCount:int = 0, useCurrentFrame:Boolean = false):void [静态] 注册给定 MovieClip 以及该 MovieClip 子级的 AnimatorBase 实例。	AnimatorBase
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		resume():void 在动画由 pause() 方法暂停后继续播放动画。	AnimatorBase
		rewind():void 将 Flash Player 设置到动画的第一帧。	AnimatorBase
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		startFrameEvents():void 启动帧事件。	AnimatorBase
		stop():void 停止播放动画，Flash Player 将返回到动画序列中的第一帧。	AnimatorBase
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		useCurrentFrame(enable:Boolean, spanStart:int):void 每次进入新帧时设置 currentFrame 属性，并设置目标动画是否与其父级 MovieClips 的时间轴中的帧同步。	AnimatorBase
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

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

构造函数详细信息

()

构造函数

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

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

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

参数

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

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

fromXMLString

()

方法

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

语言版本:

ActionScript 3.0

产品版本:

Flash CS3

运行时版本:

Flash Player 9.0.28.0, AIR 1.0

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

参数

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

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

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

matricesEqual

()

方法

public static function matricesEqual(a:Matrix, b:Matrix):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flash CS5

运行时版本:

Flash Player 10.1, AIR 2

比较以参数形式指定的两个矩阵，如果彼此相等，则返回 true。

参数

	`a:Matrix` — 要比较的第一个 Matrix 对象实例。

	`b:Matrix` — 要比较的第二个 Matrix 对象实例。

Boolean — 一个布尔值；如果两个矩阵彼此相等，则为 true，否则为 false。

法律声明 | 在线隐私策略

Animator - AS3 Flash

类 x

Animator

fromXMLString

matricesEqual