TweenEffectInstance

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

相关 API 元素

mx.effects.Tween
mx.effects.TweenEffect

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		className : String [只读] 效果类的名称，如“FadeInstance”。	EffectInstance
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		duration : Number 效果的持续时间（以毫秒为单位）。	EffectInstance
		easingFunction : Function 动画的缓动函数。	TweenEffectInstance
		effect : IEffect 创建此 IEffectInstance 对象的 IEffect 对象。	EffectInstance
		effectTargetHost : mx.effects:IEffectTargetHost 一个属性，您可以通过设置此属性访问数据效果基于列表的目标控件。	EffectInstance
		hideFocusRing : Boolean 确定在开始播放效果时，效果是否应隐藏对焦环。	EffectInstance
		playheadTime : Number [覆盖] 效果的当前时间位置。	TweenEffectInstance
		propertyChanges : PropertyChanges 指定包含一组属性的初始值和结束值的 PropertyChanges 对象，这些属性与效果的目标相关。	EffectInstance
		repeatCount : int 效果的重复次数。	EffectInstance
		repeatDelay : int 重复播放效果前需要等待的时间（以毫秒为单位）。	EffectInstance
		startDelay : int 开始播放效果前需要等待的时间（以毫秒为单位）。	EffectInstance
		suspendBackgroundProcessing : Boolean 如果为 true，则在播放效果时阻止所有背景处理。	EffectInstance
		target : Object 要应用此效果的 UIComponent 对象。	EffectInstance
		triggerEvent : Event 触发播放效果的事件（如果有）。	EffectInstance
		tween : mx.effects:Tween 用于确定动画的 Tween 对象。	TweenEffectInstance

受保护的属性

隐藏继承的受保护属性

显示继承的受保护属性

	属性		由以下参数定义
		playCount : int = 0 已播放实例的次数。	EffectInstance

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		TweenEffectInstance(target:Object) 构造函数。	TweenEffectInstance
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		end():void [覆盖] 中断当前播放的效果，并立即跳至该效果的结尾。	TweenEffectInstance
		finishEffect():void 在完成效果播放时由 end() 方法调用。	EffectInstance
		finishRepeat():void 每次完成重复效果的迭代播放后调用。	EffectInstance
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		initEffect(event:Event):void 如果由 EffectManager 触发效果，则会调用此方法。	EffectInstance
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		onTweenEnd(value:Object):void 当效果应最后一次更新目标时调用的回调方法。	TweenEffectInstance
		onTweenUpdate(value:Object):void 当效果应更新目标时调用的回调方法。	TweenEffectInstance
		pause():void 暂停效果，直到调用 resume() 方法。	EffectInstance
		play():void 在目标上播放效果实例。	EffectInstance
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		resume():void 在效果由 pause() 方法暂停后继续播放效果。	EffectInstance
		reverse():void 从效果的当前位置开始反向播放效果。	EffectInstance
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		startEffect():void 经过 startDelay 所占用的这段时间后，在目标上播放效果实例。	EffectInstance
		stop():void 停止播放效果，使目标保持当前状态。	EffectInstance
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

	方法		由以下参数定义
		createTween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1):mx.effects:Tween 创建一个 Tween 实例，为其分配开始值、结束值和持续时间值。	TweenEffectInstance

事件

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

隐藏继承的事件

显示继承的事件

	事件		摘要	由以下参数定义
		activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
		deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher

属性详细信息

easingFunction

属性

public var easingFunction:Function

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

playheadTime

属性

playheadTime:Number[覆盖]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

效果的当前时间位置。此属性的值介于 0 和总持续时间（包括该效果的 startDelay、repeatCount 和 repeatDelay）之间。

实现
override public function get playheadTime():Number
override public function set playheadTime(value:Number):void

tween

属性

public var tween:mx.effects:Tween

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

构造函数详细信息

()

构造函数

public function TweenEffectInstance(target:Object)

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

参数

target:Object — 要使用此效果为其设置动画的 Object。

方法详细信息

createTween

()

方法

 protected function createTween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1):mx.effects:Tween

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

创建一个 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 周期而暂时冻结的动画会从停止的地方重新开始，而不是突然向前跳跃。

mx.effects:Tween — 新创建的 Tween 实例。

end

()

方法

override public function end():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

此效果将调度 effectEnd 事件。

onTweenEnd

()

方法

public function onTweenEnd(value:Object):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当效果应最后一次更新目标时调用的回调方法。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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

参数

法律声明 | 在线隐私策略

TweenEffectInstance - AS3 Flex

包x

语言元素

附录

包 mx.effects.effectClasses

easingFunction

playheadTime

tween