弹性效果等级（Flex Effect Class）

优质

小牛编辑

127浏览

2023-12-01

介绍 (Introduction)

Effect类是一个抽象基类，它定义了所有Flex效果的基本功能。 Effect类为所有效果定义基础工厂类。 EffectInstance类定义所有效果实例子类的基类。

Class 声明 (Class Declaration)

以下是mx.effects.Effect类的声明 -

public class Effect
   extends EventDispatcher
      implements IEffect

公共属性 (Public Properties)

S.No	财产和描述
1	className : String [只读]效果类的名称，例如“淡入淡出”。
2	customFilter : mx.effects:EffectTargetFilter 指定EffectTargetFilter类型的自定义滤镜对象，效果使用该对象来确定播放效果的目标。
3	duration : Number 效果的持续时间（以毫秒为单位）。
4	effectTargetHost : mx.effects:IEffectTargetHost 一种属性，允许您访问基于目标列表的数据效果控件。
5	filter : String 指定用于过滤效果目标的算法。
6	hideFocusRing : Boolean 确定效果是否应在启动效果时隐藏对焦环。
7	instanceClass : Class Class类型的对象，它指定此效果类的效果实例类类。
8	isPlaying : Boolean [只读]一个只读标志，如果当前正在播放效果的任何实例，则为true;如果没有，则为false。
9	perElementOffset : Number 在效果的第一个目标之后的效果目标的附加延迟（以毫秒为单位）。
10	playheadTime : Number 效果的当前时间位置。
11	relevantProperties : Array 执行过滤时要使用的属性名称数组。
12	relevantStyles : Array 执行过滤时要使用的样式名称数组。
13	repeatCount : int = 1 重复效果的次数。
14	repeatDelay : int = 0 重复效果之前等待的时间（以毫秒为单位）。
15	startDelay : int = 0 在开始效果之前等待的时间量（以毫秒为单位）。
16	suspendBackgroundProcessing : Boolean = false 如果为true，则在播放效果时阻止所有后台处理。
17	target : Object 应用此效果的对象。
18	targets : Array 作为效果目标的对象数组。
19	triggerEvent : Event 触发效果时，EffectManager将Event对象传递给此Effect，如果EffectManager未播放效果，则为null。

受保护的属性

S.No	财产和描述
1	applyTransitionEndProperties : Boolean 此标志控制效果在转换中运行时是否根据结束状态自动应用属性值，而不是保留效果本身设置的值。
2	endValuesCaptured : Boolean = false 如果已经确定了效果的结束值，则包含true的标志;如果在效果运行时应从效果目标的当前属性获取，则返回false。

S.No

财产和描述

applyTransitionEndProperties : Boolean

此标志控制效果在转换中运行时是否根据结束状态自动应用属性值，而不是保留效果本身设置的值。

endValuesCaptured : Boolean = false

如果已经确定了效果的结束值，则包含true的标志;如果在效果运行时应从效果目标的当前属性获取，则返回false。

公共方法 (Public Methods)

S.No	方法和描述
1	Effect(target:Object = null) 构造函数。
2	captureEndValues():void 捕获效果目标上相关属性的当前值，并将其保存为结束值。
3	captureMoreStartValues(targets:Array):void 捕获另一组目标的相关属性的当前值Flex在运行数据更改效果时使用此功能。
4	captureStartValues():void 捕获效果目标上相关属性的当前值。
5	createInstance(target:Object = null):IEffectInstance 创建单个效果实例并对其进行初始化。
6	createInstances(targets:Array = null):Array 获取目标对象数组并在每个目标上调用createInstance（）方法。
7	deleteInstance(instance:IEffectInstance):void 从实例中删除事件侦听器并将其从实例列表中删除。
8	end(effectInstance:IEffectInstance = null):void 中断当前正在播放的效果，并立即跳转到效果的结尾。
9	getAffectedProperties():Array 返回一个字符串数组，其中每个String是此效果更改的属性的名称。
10	pause():void 暂停效果，直到调用resume（）方法。
11	play(targets:Array = null, playReversedFromEnd:Boolean = false):Array 开始播放效果。
12	resume():void 通过调用pause（）方法暂停后恢复效果。
13	reverse():void 如果效果当前正在播放，则从效果的当前位置开始反向播放效果。
14	stop():void 停止效果，将效果目标保持在当前状态。

受保护的方法 (Protected Methods)

S.No	方法和描述
1	*applyValueToTarget(target:Object, property:String, value:, props:Object):void** 由Effect基础结构在内部使用。
2	effectEndHandler(event:EffectEvent):void 在效果实例播放完毕后调用。
3	effectStartHandler(event:EffectEvent):void 效果实例开始播放时调用此方法。
4	effectStopHandler(event:EffectEvent):void 通过调用stop（）方法停止效果实例时调用。
5	filterInstance(propChanges:Array, target:Object):Boolean 确定过滤效果实例的逻辑。
6	getValueFromTarget(target:Object, property:String):* 由captureStartValues（）方法调用以从目标获取属性的值。
7	initInstance(instance:IEffectInstance):void 将效果的属性复制到效果实例。

事件 (Events)

S.No	活动和描述
1	effectEnd 在其中一个效果的实例完成播放时调度，无论是在实例完成播放时还是在通过调用end（）方法中断效果时调度。
2	effectStart 效果开始播放时分派。
3	effectStop 在效果停止时调度，仅在通过调用stop（）方法中断效果时发生。

S.No

活动和描述

effectEnd

在其中一个效果的实例完成播放时调度，无论是在实例完成播放时还是在通过调用end（）方法中断效果时调度。

effectStart

效果开始播放时分派。

effectStop

在效果停止时调度，仅在通过调用stop（）方法中断效果时发生。

方法继承 (Methods Inherited)

该类继承以下类中的方法 -

flash.events.EventDispatcher
Object