包 | mx.effects.effectClasses |
类 | public class TweenEffectInstance |
继承 | TweenEffectInstance EffectInstance EventDispatcher Object |
子类 | AnimatePropertyInstance, BlurInstance, DissolveInstance, FadeInstance, GlowInstance, MoveInstance, PauseInstance, ResizeInstance, RotateInstance, SeriesEffectInstance, ZoomInstance |
另请参见
属性 | 定义方 | ||
---|---|---|---|
className : String [只读 (read-only)] 效果类的名称,如“FadeInstance”。 | EffectInstance | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
duration : Number 效果的持续时间(以毫秒为单位)。 | EffectInstance | ||
easingFunction : Function 动画的缓动函数。 | TweenEffectInstance | ||
effect : IEffect 创建此 IEffectInstance 对象的 IEffect 对象。 | EffectInstance | ||
effectTargetHost : IEffectTargetHost 一个属性,您可以通过设置此属性访问数据效果基于列表的目标控件。 | EffectInstance | ||
hideFocusRing : Boolean 确定在开始播放效果时,效果是否应隐藏对焦环。 | EffectInstance | ||
playheadTime : Number [只读 (read-only)] 效果的当前位置(以毫秒为单位)。 | TweenEffectInstance | ||
propertyChanges : PropertyChanges 指定包含一组属性的初始值和结束值的 PropertyChanges 对象,这些属性与效果的目标相关。 | EffectInstance | ||
prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | ||
repeatCount : int 效果的重复次数。 | EffectInstance | ||
repeatDelay : int 重复播放效果前需要等待的时间(以毫秒为单位)。 | EffectInstance | ||
startDelay : int 开始播放效果前需要等待的时间(以毫秒为单位)。 | EffectInstance | ||
suspendBackgroundProcessing : Boolean 如果为 true,则在播放效果时阻止所有背景处理。 | EffectInstance | ||
target : Object 要应用此效果的 UIComponent 对象。 | EffectInstance | ||
triggerEvent : Event 触发播放效果的事件(如果有)。 | EffectInstance | ||
tween : Tween 用于确定动画的 Tween 对象。 | TweenEffectInstance |
方法 | 定义方 | ||
---|---|---|---|
TweenEffectInstance(target:Object) 构造函数。 | TweenEffectInstance | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | ||
将事件调度到事件流中。 | EventDispatcher | ||
中断当前播放的效果,并立即跳至该效果的结尾。 | TweenEffectInstance | ||
在完成效果播放时由 end() 方法调用。 | EffectInstance | ||
每次完成重复效果的迭代播放后调用。 | EffectInstance | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | ||
指示对象是否已经定义了指定的属性。 | Object | ||
如果由 EffectManager 触发效果,则会调用此方法。 | EffectInstance | ||
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
当效果应最后一次更新目标时调用的回调方法。 | TweenEffectInstance | ||
当效果应更新目标时调用的回调方法。 | TweenEffectInstance | ||
暂停效果,直到调用 resume() 方法。 | EffectInstance | ||
在目标上播放效果实例。 | EffectInstance | ||
指示指定的属性是否存在、是否可枚举。 | Object | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
在效果由 pause() 方法暂停后继续播放效果。 | EffectInstance | ||
从效果的当前位置开始反向播放效果。 | EffectInstance | ||
将效果前移到指定位置。 | TweenEffectInstance | ||
设置循环操作动态属性的可用性。 | Object | ||
经过 startDelay 所占用的这段时间后,在目标上播放效果实例。 | EffectInstance | ||
停止播放效果,使目标保持当前状态。 | EffectInstance | ||
返回指定对象的字符串表示形式。 | Object | ||
返回指定对象的原始值。 | Object | ||
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher |
方法 | 定义方 | ||
---|---|---|---|
createTween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1):Tween 创建一个 Tween 实例,为其分配开始值、结束值和持续时间值。 | TweenEffectInstance |
easingFunction | 属性 |
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 | () | 构造函数 |
createTween | () | 方法 |
protected function createTween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1):Tween
创建一个 Tween 实例,为其分配开始值、结束值和持续时间值。如果已指定缓动函数,则会将其分配给 Tween 实例。会为 Tween 实例的以下 TweenEvent 分配事件侦听器:tweenStart
、tweenUpdate
、tweenEnd
。通常,您可以从用于快速启动动画计时器的 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:Object —
value 参数的值是一个插补值,由 Tween.startValue 属性、Tween.endValue 属性和 interpolation 函数确定,这些属性和函数是通过在效果的 play() 方法中实现此效果指定的。play() 方法可使用这些值创建一个 Tween 对象,用于在某时间段内播放此效果。value 参数可以是 Number,也可以是 Number 的 Array。
|
onTweenUpdate | () | 方法 |
public function onTweenUpdate(value:Object):void
当效果应更新目标时调用的回调方法。Tween 类使用缓动函数以及 Tween.startValue
、Tween.endValue
和 Tween.duration
属性来计算 value
参数的值。value
参数可以是 Number,也可以是 Number 的 Array。
所有子类都必须覆盖此方法。覆盖此方法时无需调用此函数的超级版本。
参数
value:Object —
value 参数的值是一个插补值,由 Tween.startValue 属性、Tween.endValue 属性和 interpolation 函数确定,这些属性和函数是通过在效果的 play() 方法中实现此效果指定的。play() 方法可使用这些值创建一个 Tween 对象,用于在某时间段内播放此效果。value 参数可以是 Number,也可以是 Number 的 Array。
|
seek | () | 方法 |
public function seek(playheadTime:Number):void
将效果前移到指定位置。
参数
playheadTime:Number —
介于 0 和 duration 属性的值之间的位置(以毫秒为单位)。
|