用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
mx.effects 

CompositeEffect  - AS3 Flex

mx.effects
public class CompositeEffect
继承CompositeEffect Inheritance Effect Inheritance EventDispatcher Inheritance Object
子类 Parallel, Sequence

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

CompositeEffect 类是 Parallel 类和 Sequence 类的父类,这两个类定义 <mx:Parallel><mx:Sequence>MXML 标签。Flex 支持采用以下两种方法来组合或复合效果:并行和排序。以并行方式组合多个效果时,会同时播放这些效果。以排序方式组合多个效果时,在下一效果开始之前必须完成上一个效果。

您可以在 MXML 中创建复合效果,如以下示例所示:

  <mx:Parallel id="WipeRightUp">
    <mx:children>
      <mx:WipeRight duration="1000"/>
      <mx:WipeUp duration="1000"/>
    </mx:children>
  </mx:Parallel>
   
  <mx:VBox id="myBox" hideEffect="WipeRightUp">
    <mx:TextArea id="aTextArea" text="hello"/>
  </mx:VBox>
  

<mx:children> 标签是可选的。

在 ActionScript 中启动 composite 效果通常分为五个步骤:

  1. 创建要组合到一起的效果对象的实例,例如:
    myFadeEffect = new mx.effects.Fade(target);
  2. 在各个效果对象上设置属性,如 duration
  3. 创建 Parallel 或 Sequence 效果对象的实例;例如:
    mySequenceEffect = new mx.effects.Sequence();
  4. 针对每个效果对象调用 addChild() 方法,例如:
    mySequenceEffect.addChild(myFadeEffect);
  5. 调用复合效果的 play() 方法;例如:
    mySequenceEffect.play();

MXML 语法expanded隐藏 MXML 语法

The CompositeEffect class adds the following tag attributes, and all the subclasses of the CompositeEffect class inherit these tag attributes:

  <mx:tagname>
    <mx:children>
      <!-- Specify child effect tags --> 
    </mx:children>
  </mx:tagname>
  

默认 MXML 属性children



公共属性
 属性由以下参数定义
  children : Array
包含此 CompositeEffect 的子效果的数组。
CompositeEffect
 InheritedclassName : String
[只读] 效果类的名称,如“Fade”。
Effect
  compositeDuration : Number
[只读] 返回此效果的持续时间,由所有子效果的持续时间进行定义。
CompositeEffect
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcustomFilter : mx.effects:EffectTargetFilter
指定一个 EffectTargetFilter 类型的自定义滤镜对象,效果将使用此对象来确定播放效果的目标。
Effect
 Inheritedduration : Number
效果的持续时间(以毫秒为单位)。
Effect
 InheritedeffectTargetHost : mx.effects:IEffectTargetHost
一个属性,您可以通过设置此属性访问数据效果基于列表的目标控件。
Effect
 Inheritedfilter : String
指定用于过滤效果目标的算法。
Effect
 InheritedhideFocusRing : Boolean
确定在开始播放效果时,效果是否应隐藏对焦环。
Effect
 InheritedinstanceClass : Class
一个 Class 类型的对象,用于指定此效果类的效果实例类。
Effect
 InheritedisPlaying : Boolean
[只读] 一个只读标志,如果当前正在播放效果的任一实例,则为 true;否则,则为 false。
Effect
 InheritedperElementOffset : Number
在效果的第一个目标之后,其他效果目标的附加延迟(以毫秒为单位)。
Effect
 InheritedplayheadTime : Number
效果的当前时间位置。
Effect
 InheritedrelevantProperties : Array
一个属性名称 Array,执行过滤时将使用这些名称。
Effect
 InheritedrelevantStyles : Array
一个样式名称 Array,执行过滤时将使用这些名称。
Effect
 InheritedrepeatCount : int = 1
效果的重复次数。
Effect
 InheritedrepeatDelay : int = 0
重复播放效果前需要等待的时间(以毫秒为单位)。
Effect
 InheritedstartDelay : int = 0
开始播放效果前需要等待的时间(以毫秒为单位)。
Effect
 InheritedsuspendBackgroundProcessing : Boolean = false
如果为 true,则在播放效果时阻止所有背景处理。
Effect
 Inheritedtarget : Object
要应用此效果的对象。
Effect
 Inheritedtargets : Array
一个对象 Array,这些对象都是效果的目标。
Effect
 InheritedtriggerEvent : Event
如果触发了某个效果,则此项目是由 EffectManager 传递给此 Effect 的 Event 对象;如果 EffectManager 当前没有播放此效果,则为 null。
Effect
受保护的属性
 属性由以下参数定义
 InheritedapplyTransitionEndProperties : Boolean
此标志控制该效果(进行转换时)是否将根据结束状态自动应用属性值,这与将值保留为效果本身所设置的值相反。
Effect
 InheritedendValuesCaptured : Boolean = false
一个标志,如果已确定效果的结束值,则该标志中包含 true;如果需要在效果运行时从效果目标的当前属性捕获这些值,则其中包含 false。
Effect
公共方法
 方法由以下参数定义
  
CompositeEffect(target:Object = null)
构造函数。
CompositeEffect
  
addChild(childEffect:IEffect):void
将新的子效果添加到此复合效果。
CompositeEffect
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
捕获效果目标上相关属性的当前值,并将这些值另存为结束值。
Effect
 Inherited
捕获另一组目标相关属性的当前值。在运行数据更改效果时,Flex 将使用此函数。
Effect
 Inherited
捕获效果目标上相关属性的当前值。
Effect
 Inherited
创建一个效果实例并对其进行初始化。
Effect
 Inherited
createInstances(targets:Array = null):Array
获取一个目标对象 Array,并对每个目标调用 createInstance() 方法。
Effect
 Inherited
删除实例中的事件侦听器,然后从实例列表中删除该实例。
Effect
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
end(effectInstance:IEffectInstance = null):void
中断当前正在播放的效果,立即跳转到该效果的末尾。
Effect
 Inherited
返回一个字符串 Array,其中每个 String 都是被此效果更改的属性的名称。
Effect
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
暂停效果,直到调用 resume() 方法。
Effect
 Inherited
play(targets:Array = null, playReversedFromEnd:Boolean = false):Array
开始播放效果。
Effect
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
在效果由 pause() 方法暂停后继续播放效果。
Effect
 Inherited
逆序播放效果;如果当前正在播放效果,则从该效果的当前位置开始逆序播放。
Effect
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
停止播放效果,使效果目标保持当前状态。
Effect
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。
EventDispatcher
受保护的方法
 方法由以下参数定义
 Inherited
applyValueToTarget(target:Object, property:String, value:*, props:Object):void
供 Effect 基础结构内部使用。
Effect
 Inherited
当效果实例完成播放时调用。
Effect
 Inherited
当效果实例开始播放时调用此方法。
Effect
 Inherited
当效果实例已被 stop() 方法调用停止时调用。
Effect
 Inherited
filterInstance(propChanges:Array, target:Object):Boolean
确定筛选效果实例所用的逻辑。
Effect
 Inherited
getValueFromTarget(target:Object, property:String):*
由 captureStartValues() 方法调用,用来从目标获得某个属性的值。
Effect
 Inherited
将效果的属性复制到效果实例。
Effect
事件
 事件 摘要 由以下参数定义
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
 Inherited在其中一个效果实例完成播放时(既可以是实例实际完成播放时,也可以是通过调用 end() 方法中断效果时)调度。Effect
 Inherited当效果开始播放时调度。Effect
 Inherited在已停止效果时调度,仅当该效果已被 stop() 方法调用中断时才会发生。Effect
属性详细信息

children

属性
children:Array

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

包含此 CompositeEffect 的子效果的数组。



实现
    public function get children():Array
    public function set children(value:Array):void

compositeDuration

属性 
compositeDuration:Number  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

返回此效果的持续时间,由所有子效果的持续时间进行定义。这会考虑所有子效果的 startDelay 和重复信息,以及其持续时间,并返回相应的结果。



实现
    public function get compositeDuration():Number
构造函数详细信息

CompositeEffect

()构造函数
public function CompositeEffect(target:Object = null)

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

构造函数。

参数
target:Object (default = null) — 复合效果会忽略此参数。包含此参数的目的只是为了与其他类型的效果保持一致。
方法详细信息

addChild

()方法
public function addChild(childEffect:IEffect):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

将新的子效果添加到此复合效果。Sequence 效果按照子效果的添加顺序播放子效果,一次播放一个。Parallel 效果同时播放所有子效果;添加子效果的顺序无关紧要。

参数

childEffect:IEffect — 要添加到复合效果的子效果。





[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。