| 包 | 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 语法