mx.effects.effectClasses
public class TweenEffectInstance
继承TweenEffectInstance Inheritance EffectInstance Inheritance EventDispatcher Inheritance Object
子类 AnimatePropertyInstance, BlurInstance, DissolveInstance, FadeInstance, GlowInstance, MoveInstance, PauseInstance, ResizeInstance, RotateInstance, SeriesEffectInstance, ZoomInstance

TweenEffectInstance 类用于实现 TweenEffect 的实例类。Flex 在播放 TweenEffect 时会自动创建此类的实例;您无需自己创建。

另请参见

mx.effects.Tween
mx.effects.TweenEffect
About creating a custom effect
About tween effects


公共属性
 属性定义方
 InheritedclassName : String
[只读 (read-only)] 效果类的名称,如“FadeInstance”。
EffectInstance
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheritedduration : Number
效果的持续时间(以毫秒为单位)。
EffectInstance
  easingFunction : Function
动画的缓动函数。
TweenEffectInstance
 Inheritedeffect : IEffect
创建此 IEffectInstance 对象的 IEffect 对象。
EffectInstance
 InheritedeffectTargetHost : IEffectTargetHost
一个属性,您可以通过设置此属性访问数据效果基于列表的目标控件。
EffectInstance
 InheritedhideFocusRing : Boolean
确定在开始播放效果时,效果是否应隐藏对焦环。
EffectInstance
  playheadTime : Number
[只读 (read-only)] 效果的当前位置(以毫秒为单位)。
TweenEffectInstance
 InheritedpropertyChanges : PropertyChanges
指定包含一组属性的初始值和结束值的 PropertyChanges 对象,这些属性与效果的目标相关。
EffectInstance
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
 InheritedrepeatCount : int
效果的重复次数。
EffectInstance
 InheritedrepeatDelay : int
重复播放效果前需要等待的时间(以毫秒为单位)。
EffectInstance
 InheritedstartDelay : int
开始播放效果前需要等待的时间(以毫秒为单位)。
EffectInstance
 InheritedsuspendBackgroundProcessing : Boolean
如果为 true,则在播放效果时阻止所有背景处理。
EffectInstance
 Inheritedtarget : Object
要应用此效果的 UIComponent 对象。
EffectInstance
 InheritedtriggerEvent : Event
触发播放效果的事件(如果有)。
EffectInstance
  tween : Tween
用于确定动画的 Tween 对象。
TweenEffectInstance
公共方法
 方法定义方
  
构造函数。
TweenEffectInstance
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
将事件调度到事件流中。
EventDispatcher
  
中断当前播放的效果,并立即跳至该效果的结尾。
TweenEffectInstance
 Inherited
在完成效果播放时由 end() 方法调用。
EffectInstance
 Inherited
每次完成重复效果的迭代播放后调用。
EffectInstance
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
如果由 EffectManager 触发效果,则会调用此方法。
EffectInstance
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
当效果应最后一次更新目标时调用的回调方法。
TweenEffectInstance
  
当效果应更新目标时调用的回调方法。
TweenEffectInstance
 Inherited
暂停效果,直到调用 resume() 方法。
EffectInstance
 Inherited
在目标上播放效果实例。
EffectInstance
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
在效果由 pause() 方法暂停后继续播放效果。
EffectInstance
 Inherited
从效果的当前位置开始反向播放效果。
EffectInstance
  
seek(playheadTime:Number):void
将效果前移到指定位置。
TweenEffectInstance
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
经过 startDelay 所占用的这段时间后,在目标上播放效果实例。
EffectInstance
 Inherited
停止播放效果,使目标保持当前状态。
EffectInstance
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
受保护的方法
 方法定义方
  
createTween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1):Tween
创建一个 Tween 实例,为其分配开始值、结束值和持续时间值。
TweenEffectInstance
事件
 事件 摘要 定义方
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
属性详细信息
easingFunction属性
public var easingFunction:Function

动画的缓动函数。默认情况下,效果会使用同一缓动函数作为 TweenEffect 类。

另请参见

playheadTime属性 
playheadTime:Number  [只读 (read-only)]

效果的当前位置(以毫秒为单位)。此值介于 0 和 duration 属性的值之间。使用 seek() 方法可更改效果的位置。



实现
    public function get playheadTime():Number
tween属性 
public var tween:Tween

用于确定动画的 Tween 对象。要创建效果,必须在 EffectInstance.play() 方法的覆盖中创建一个 Tween 实例,并将其分配给 tween 属性。使用 createTween() 方法创建您的 Tween 对象。

构造函数详细信息
TweenEffectInstance()构造函数
public function TweenEffectInstance(target:Object)

构造函数。

参数
target:Object — 要使用此效果为其设置动画的 Object。
方法详细信息
createTween()方法
protected function createTween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1):Tween

创建一个 Tween 实例,为其分配开始值、结束值和持续时间值。如果已指定缓动函数,则会将其分配给 Tween 实例。会为 Tween 实例的以下 TweenEvent 分配事件侦听器:tweenStarttweenUpdatetweenEnd。通常,您可以从用于快速启动动画计时器的 EffectInstance.play() 方法的覆盖调用此方法。

参数

listener:Object — 在每个动画间隔通知的对象。通常会将 this 关键字作为其值进行传递。listener 必须定义 onTweenUpdate() 方法,并可以选择定义 onTweenEnd() 方法。onTweenUpdate() 方法在动画效果的每个间隔期间调用,而 onTweenEnd() 方法只在动画完成后调用。
 
startValue:Object — 动画的初始值。可能是数字,也可能是数字的 Array。如果传递的是数字,则 Tween 会在此数字与传递给 endValue 参数的数字之间进行插值。如果传递的是数字的 Array,则插补 Array 中的每个数字。
 
endValue:Object — 动画的最终值。此参数的类型必须与 startValue 参数相匹配。
 
duration:Number (default = -1) — 动画的持续时间(以毫秒为单位)。
 
minFps:Number (default = -1)onTweenUpdate() 方法在每秒钟的最少调用次数。补间代码会尝试尽量多调用 onTweenUpdate() 方法(每秒钟至多 100 次)。但是,如果频率低于 minFps,则动画的持续时间会自动增加。这样,由于未能获得任何 CPU 周期而暂时冻结的动画会从停止的地方重新开始,而不是突然向前跳跃。

返回
Tween — 新创建的 Tween 实例。
end()方法 
override public function end():void

中断当前播放的效果,并立即跳至该效果的结尾。调用 tween 属性上的 Tween.endTween() 方法。此方法可实现 superclass 的方法。

如果您创建了 TweenEffectInstance 的子类,则可以选择覆盖此方法。

此效果将调度 effectEnd 事件。

另请参见

onTweenEnd()方法 
public function onTweenEnd(value:Object):void

当效果应最后一次更新目标时调用的回调方法。Tween 类将 Tween.endValue 作为 value 参数的值传递。value 参数可以是 Number,也可以是 Number 的 Array。

可以选择覆盖此函数。当逻辑结束后,您还必须在覆盖的末尾调用此方法的超级版本 super.onTweenEnd(val)

参数

value:Objectvalue 参数的值是一个插补值,由 Tween.startValue 属性、Tween.endValue 属性和 interpolation 函数确定,这些属性和函数是通过在效果的 play() 方法中实现此效果指定的。play() 方法可使用这些值创建一个 Tween 对象,用于在某时间段内播放此效果。value 参数可以是 Number,也可以是 Number 的 Array。

onTweenUpdate()方法 
public function onTweenUpdate(value:Object):void

当效果应更新目标时调用的回调方法。Tween 类使用缓动函数以及 Tween.startValueTween.endValueTween.duration 属性来计算 value 参数的值。value 参数可以是 Number,也可以是 Number 的 Array。

所有子类都必须覆盖此方法。覆盖此方法时无需调用此函数的超级版本。

参数

value:Objectvalue 参数的值是一个插补值,由 Tween.startValue 属性、Tween.endValue 属性和 interpolation 函数确定,这些属性和函数是通过在效果的 play() 方法中实现此效果指定的。play() 方法可使用这些值创建一个 Tween 对象,用于在某时间段内播放此效果。value 参数可以是 Number,也可以是 Number 的 Array。

seek()方法 
public function seek(playheadTime:Number):void

将效果前移到指定位置。

参数

playheadTime:Number — 介于 0 和 duration 属性的值之间的位置(以毫秒为单位)。