| 包 | mx.effects | 
| 类 | public class AddChildAction | 
| 继承 | AddChildAction    Effect   EventDispatcher   Object | 
| 语言版本: | ActionScript 3.0 | 
| 产品版本: | Flex 3 | 
| 运行时版本: | Flash Player 9, AIR 1.1 | 
![]()  | 从 Flex 4.0 开始,Adobe 建议您使用 spark.effects.AddAction 类来替代此类。 | 
AddChildAction 类定义对应于视图状态定义的
AddChild 属性的动画效果。您可以使用过渡定义中的 AddChildAction 效果控制过渡期间何时发生 AddChild 属性定义的视图状态更改。
  
  MXML 语法
隐藏 MXML 语法The <mx:AddChildAction> tag
  inherits all of the tag attributes of its superclass,
  and adds the following tag attributes:
  <mx:AddChildAction
    Properties
    id="ID"
    index="-1"
    relativeTo=""
    position="index"
  />
  
  
  相关 API 元素
公共属性
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
![]()  | className : String [只读] 
      效果类的名称,如“Fade”。  | Effect | |
![]()  | constructor : Object 
	 对类对象或给定对象实例的构造函数的引用。  | Object | |
![]()  | customFilter : mx.effects:EffectTargetFilter 
      指定一个 EffectTargetFilter 类型的自定义滤镜对象,效果将使用此对象来确定播放效果的目标。  | Effect | |
![]()  | effectTargetHost : mx.effects:IEffectTargetHost 
      一个属性,您可以通过设置此属性访问数据效果基于列表的目标控件。  | Effect | |
![]()  | filter : String 
      指定用于过滤效果目标的算法。  | Effect | |
![]()  | hideFocusRing : Boolean 
      确定在开始播放效果时,效果是否应隐藏对焦环。  | Effect | |
| index : int = -1  
	  父项中子项的索引。  | AddChildAction | ||
![]()  | instanceClass : Class 
      一个 Class 类型的对象,用于指定此效果类的效果实例类。  | Effect | |
![]()  | isPlaying : Boolean [只读] 
      一个只读标志,如果当前正在播放效果的任一实例,则为 true;否则,则为 false。  | Effect | |
![]()  | perElementOffset : Number 
      在效果的第一个目标之后,其他效果目标的附加延迟(以毫秒为单位)。  | Effect | |
![]()  | playheadTime : Number 
      效果的当前时间位置。  | Effect | |
| position : String = "index"  
	  显示列表中子项的位置,随 relativeTo 属性指定的对象而变化。  | AddChildAction | ||
| relativeTo : DisplayObjectContainer  
	  子组件的添加位置。  | AddChildAction | ||
![]()  | relevantProperties : Array 
      一个属性名称 Array,执行过滤时将使用这些名称。  | Effect | |
![]()  | relevantStyles : Array 
      一个样式名称 Array,执行过滤时将使用这些名称。  | Effect | |
![]()  | repeatCount : int = 1 
      效果的重复次数。  | Effect | |
![]()  | repeatDelay : int = 0 
      重复播放效果前需要等待的时间(以毫秒为单位)。  | Effect | |
![]()  | startDelay : int = 0 
      开始播放效果前需要等待的时间(以毫秒为单位)。  | Effect | |
![]()  | suspendBackgroundProcessing : Boolean = false 
      如果为 true,则在播放效果时阻止所有背景处理。  | Effect | |
![]()  | target : Object  
      要应用此效果的对象。  | Effect | |
![]()  | targets : Array 
      一个对象 Array,这些对象都是效果的目标。  | Effect | |
![]()  | triggerEvent : Event 
      如果触发了某个效果,则此项目是由 EffectManager 传递给此 Effect 的 Event 对象;如果 EffectManager 当前没有播放此效果,则为 null。  | Effect | |
受保护的属性
公共方法 
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
AddChildAction(target:Object = null) 
	  构造函数。  | AddChildAction | ||
![]()  | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 
	使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。  | EventDispatcher | |
![]()  | 
      捕获效果目标上相关属性的当前值,并将这些值另存为结束值。  | Effect | |
![]()  | 
      捕获另一组目标相关属性的当前值。在运行数据更改效果时,Flex 将使用此函数。
     
        | Effect | |
![]()  | 
      捕获效果目标上相关属性的当前值。  | Effect | |
![]()  | 
      创建一个效果实例并对其进行初始化。  | Effect | |
![]()  | 
      获取一个目标对象 Array,并对每个目标调用 createInstance() 方法。  | Effect | |
![]()  | 
      删除实例中的事件侦听器,然后从实例列表中删除该实例。  | Effect | |
![]()  | 
	将事件调度到事件流中。  | EventDispatcher | |
![]()  | 
      中断当前正在播放的效果,立即跳转到该效果的末尾。  | Effect | |
![]()  | 
      返回一个字符串 Array,其中每个 String 都是被此效果更改的属性的名称。  | Effect | |
![]()  | 
	检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。  | EventDispatcher | |
![]()  | 
	 表示对象是否已经定义了指定的属性。  | Object | |
![]()  | 
	 表示 Object 类的实例是否在指定为参数的对象的原型链中。  | Object | |
![]()  | 
      暂停效果,直到调用 resume() 方法。  | Effect | |
![]()  | 
      开始播放效果。  | Effect | |
![]()  | 
	 表示指定的属性是否存在、是否可枚举。  | Object | |
![]()  | 
	从 EventDispatcher 对象中删除侦听器。  | EventDispatcher | |
![]()  | 
      在效果由 pause() 方法暂停后继续播放效果。  | Effect | |
![]()  | 
      逆序播放效果;如果当前正在播放效果,则从该效果的当前位置开始逆序播放。  | Effect | |
![]()  | 
     设置循环操作动态属性的可用性。  | Object | |
![]()  | 
      停止播放效果,使效果目标保持当前状态。  | Effect | |
![]()  | 
	 返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。  | Object | |
![]()  | 
	 返回指定对象的字符串表示形式。  | Object | |
![]()  | 
	 返回指定对象的原始值。  | Object | |
![]()  | 
	检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。  | EventDispatcher | |
受保护的方法 
属性详细信息
index | 属性 | 
public var index:int = -1| 语言版本: | ActionScript 3.0 | 
| 产品版本: | Flex 3 | 
| 运行时版本: | Flash Player 9, AIR 1.1 | 
父项中子项的索引。值 -1 表示将子项添加为父项的最后一个子项。
 默认值为 -1。
position | 属性 | 
public var position:String = "index"| 语言版本: | ActionScript 3.0 | 
| 产品版本: | Flex 3 | 
| 运行时版本: | Flash Player 9, AIR 1.1 | 
 
	  显示列表中子项的位置,随 relativeTo 属性指定的对象而变化。有效值为 "before"、"after"、"firstChild"、"lastChild" 和 "index",其中 "index" 指定使用 index 属性确定子项的位置。
	 
	  
 默认值为 "index"。
relativeTo | 属性 | 
public var relativeTo:DisplayObjectContainer| 语言版本: | ActionScript 3.0 | 
| 产品版本: | Flex 3 | 
| 运行时版本: | Flash Player 9, AIR 1.1 | 
 
	  子组件的添加位置。默认情况下,Flex 根据视图状态定义中的 AddChild 属性定义确定此值。
	  
	  
构造函数详细信息
AddChildAction | () | 构造函数 | 
示例 如何使用本示例 
TransitionExample.mxml
<?xml version="1.0" ?>
<!-- Simple example to demonstrate the Transition class. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
    xmlns:s="library://ns.adobe.com/flex/spark"
    xmlns:mx="library://ns.adobe.com/flex/mx" currentState="Login">
 
    <!-- Define the view states -->
    <s:states>
        <s:State name="Login" />
        <s:State name="Register" />
    </s:states>
    <s:transitions>
        <!-- Define the transition from the base state to the Register state.-->
        <s:Transition id="toRegister" fromState="*" toState="Register">
            <s:Sequence targets="{[loginPanel, registerLink, confirm, loginLink]}">
                <s:RemoveAction />
                <s:Fade />
                <s:SetAction target="{loginPanel}" property="title" />
                <s:SetAction target="{loginButton}" property="label" />
                <s:SetAction target="{loginButton}" property="color" />
                <s:Resize target="{loginPanel}"/>
                <s:AddAction />
                <s:Fade />
            </s:Sequence>
        </s:Transition>
        <!-- Define the transition from the Register state to the base state.-->
        <s:Transition id="toDefault" fromState="Register" toState="*">
            <s:Sequence targets="{[loginPanel, registerLink, 
                    confirm, loginLink]}">
                <s:RemoveAction/>
                <s:SetAction target="{loginPanel}" property="title"/>
                <s:SetAction  target="{loginButton}" property="label"/>
                <s:SetAction target="{loginButton}" property="color"/>
                <s:Resize target="{loginPanel}"/>
                <s:AddAction/>
            </s:Sequence>
        </s:Transition>
    </s:transitions>
    <!-- Define a Panel container that defines the login form. The title of the Panel
         changes depending on the state. -->
    <s:Panel title="Login" title.Register="Register" id="loginPanel" 
            width="75%" horizontalCenter="0" verticalCenter="0">
    <s:controlBarLayout >
        <s:BasicLayout />
    </s:controlBarLayout>
    <s:layout>
        <s:VerticalLayout paddingTop="10" paddingBottom="10" paddingRight="10" paddingLeft="10" />
    </s:layout>
        <s:Label color="blue" width="100%"
            text="Click the 'Need to Register?' link to change state. Click the 'Return to Login' link to return to the base state."/>
        <!-- The following form has  two TextInputs in the Login state and three TextInputs
             in the Register state. -->
        <s:Form id="loginForm" >
            <s:FormItem label="Username:">
                <s:TextInput/>
            </s:FormItem>
            <s:FormItem label="Password:">
                <s:TextInput/>
            </s:FormItem>
            <s:FormItem id="confirm" label="Confirm:" includeIn="Register" includeInLayout="false" includeInLayout.Register="true">
                <s:TextInput/>
            </s:FormItem>
        </s:Form>
       
        <!-- The controlBar includes two visible items in each state. Which LinkButton is visible is determined
             by the state -->
        <s:controlBarContent>
            <mx:LinkButton id="registerLink"  label="Need to Register?" top="10" bottom="10"
                click="currentState='Register'" left="10" includeIn="Login" />
            <mx:LinkButton id="loginLink" label="Return to Login" click="currentState=''" includeIn="Register" left="10"  top="10" bottom="10"/>
            <s:Button label="Login" label.Register="Register" id="loginButton" right="10" color.Register="0x0000FF"  top="10" bottom="10"/>
        </s:controlBarContent>
    </s:Panel>
</s:Application>
Tue Jun 12 2018, 11:04 AM Z
 
显示 MXML 语法