EffectInstance

包	mx.effects
类	public class EffectInstance
继承	EffectInstance EventDispatcher Object
实现	IEffectInstance
子类	ActionEffectInstance, AnimateInstance, CompositeEffectInstance, MaskEffectInstance, SoundEffectInstance, TweenEffectInstance

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

EffectInstance 类代表在目标上播放的效果实例。每个目标都有与之相关联的单独效果实例。效果实例的生存期是短暂的。在目标上播放效果时会创建一个实例，当效果完成播放时将破坏此实例。如果目标上同时播放了多个效果（例如，Parallel 效果），则每个效果都有其单独的效果实例。

效果开发人员必须为其自定义效果创建实例类。

相关 API 元素

mx.effects.Effect

公共属性

隐藏继承的公共属性

显示继承的公共属性

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

受保护的属性

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

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		EffectInstance(target:Object) 构造函数。	EffectInstance
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		end():void 中断当前播放的效果实例，立即跳转到效果的结束位置。	EffectInstance
		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
		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

事件

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

隐藏继承的事件

显示继承的事件

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

属性详细信息

className

属性

className:String [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

效果类的名称，如 "FadeInstance"。

这是一个短类名称或“非限定”类名称，不包含包名称。如果需要限定名称，可使用 flash.utils 包中的 getQualifiedClassName() 方法。

实现
public function get className():String

duration

属性

duration:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

效果的持续时间（以毫秒为单位）。

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

effect

属性

effect:IEffect

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

创建此 IEffectInstance 对象的 IEffect 对象。

实现
public function get effect():IEffect
public function set effect(value:IEffect):void

effectTargetHost

属性

effectTargetHost:mx.effects:IEffectTargetHost

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个属性，您可以通过设置此属性访问数据效果基于列表的目标控件。通过设置此属性，效果类的实例将能够访问播放此效果的基于列表的控件。

实现
public function get effectTargetHost():mx.effects:IEffectTargetHost
public function set effectTargetHost(value:mx.effects:IEffectTargetHost):void

hideFocusRing

属性

hideFocusRing:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

确定在开始播放效果时，效果是否应隐藏对焦环。效果目标负责隐藏对焦环。UIComponent 类的子类将自动隐藏对焦环。如果效果目标不是 UIComponent 类的子类，则必须向其添加隐藏对焦环的功能。

将此属性设置为 true 可在播放效果期间隐藏对焦环。

对于 Effect 的子类，默认值是 false。对于 MaskEffect 的子类，默认值是 true。

实现
public function get hideFocusRing():Boolean
public function set hideFocusRing(value:Boolean):void

playCount

属性

protected var playCount:int = 0

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

已播放实例的次数。

playheadTime

属性

playheadTime:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

propertyChanges

属性

propertyChanges:PropertyChanges

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指定包含一组属性的初始值和结束值的 PropertyChanges 对象，这些属性与效果的目标相关。只有对创建此效果实例的效果调用 captureStartValues() 方法时，才设置此属性。

通常使用 propertyChanges 属性创建转移过程中使用的效果。Flex 会在开始转移时自动调用 captureStartValues() 方法。在覆盖 Effectinstance.play() 方法的过程中，您可以检查 propertyChanges() 方法中的信息，以初始化效果的起始值和结束值。

实现
public function get propertyChanges():PropertyChanges
public function set propertyChanges(value:PropertyChanges):void

repeatCount

属性

repeatCount:int

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

效果的重复次数。可能的值为任何大于等于 0 的整数。

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

repeatDelay

属性

repeatDelay:int

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

重复播放效果前需要等待的时间（以毫秒为单位）。

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

startDelay

属性

startDelay:int

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

开始播放效果前需要等待的时间（以毫秒为单位）。此值可以是任何大于或等于 0 的整数。如果使用 repeatCount 属性重复播放效果，则只在首次播放该效果时应用 startDelay 属性。

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

suspendBackgroundProcessing

属性

suspendBackgroundProcessing:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果为 true，则在播放效果时阻止所有背景处理。背景处理包括度量、布局和处理来自服务器的响应。

实现
public function get suspendBackgroundProcessing():Boolean
public function set suspendBackgroundProcessing(value:Boolean):void

target

属性

target:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

要应用此效果的 UIComponent 对象。

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

triggerEvent

属性

triggerEvent:Event

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

触发播放效果的事件（如果有）。如果要将一个效果分配给多个触发事件，此属性非常有用。

如果通过调用 play() 方法以编程方式播放（而非由某个事件触发）该效果，则此属性将为 null。

实现
public function get triggerEvent():Event
public function set triggerEvent(value:Event):void

构造函数详细信息

()

构造函数

public function EffectInstance(target:Object)

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

参数

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

方法详细信息

end

()

方法

public function end():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

中断当前播放的效果实例，立即跳转到效果的结束位置。通过调用 Effect.end() 方法可调用此方法。在实现过程中，它会调用 finishEffect() 方法。

如果调用此方法来结束播放效果，效果实例将调度 effectEnd 事件。

在 EffectInstance 的子类中，您可以在进行覆盖时顺便覆盖此方法，并应在完成您的逻辑之后从覆盖的结束位置调用 super.end() 方法。

finishEffect

()

方法

public function finishEffect():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在完成效果播放时由 end() 方法调用。此函数将为效果目标调度 endEffect 事件。

您不必在子类中覆盖此方法。在使用效果时无需调用此方法，但在创建效果子类时可能需要调用此方法。

finishRepeat

()

方法

public function finishRepeat():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

每次完成重复效果的迭代播放后调用。

您不必在子类中覆盖此方法。您无需在使用效果时调用此方法。

initEffect

()

方法

public function initEffect(event:Event):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果由 EffectManager 触发效果，则会调用此方法。此基类版本会将触发效果的事件保存在 triggerEvent 属性中。每个子类都应该覆盖此方法。

参数

event:Event — 为触发效果而调度的 Event 对象。例如，如果触发器是 mouseDownEffect，则事件可能是类型等效于 MouseEvent.MOUSEDOWN 的 MouseEvent。

pause

()

方法

public function pause():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

暂停效果，直到调用 resume() 方法。

play

()

方法

public function play():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在目标上播放效果实例。改为调用 startEffect() 方法，以在 EffectInstance 上开始播放效果。

在 EffectInstance 的子类中，必须覆盖此方法。此覆盖必须调用 super.play() 方法，以便从目标中调度 effectStart 事件。

resume

()

方法

public function resume():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在效果由 pause() 方法暂停后继续播放效果。

reverse

()

方法

public function reverse():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

从效果的当前位置开始反向播放效果。

startEffect

()

方法

public function startEffect():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

经过 startDelay 所占用的这段时间后，在目标上播放效果实例。由 Effect 类调用。在启动 EffectInstance 时，请使用此函数，而非 play() 方法。

stop

()

方法

public function stop():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

停止播放效果，使目标保持当前状态。您需要通过调用 Effect.stop() 方法来调用此方法。在实现过程中，它会调用 finishEffect() 方法。

如果调用此方法来结束播放效果，效果实例将调度 effectEnd 事件。

法律声明 | 在线隐私策略

EffectInstance - AS3 Flex

类 x

className

duration

effect

effectTargetHost

hideFocusRing

playCount

playheadTime

propertyChanges

repeatCount

repeatDelay

startDelay

suspendBackgroundProcessing

target

triggerEvent

EffectInstance

end

finishEffect

finishRepeat

initEffect

pause

play

resume

reverse

startEffect

stop