(仅限 Flex 数据可视化组件)
mx.charts.effects
public class SeriesEffect
继承SeriesEffect Inheritance TweenEffect Inheritance Effect Inheritance EventDispatcher Inheritance Object
子类 SeriesInterpolate, SeriesSlide, SeriesZoom

图表效果的基类。

MXML 语法expanded隐藏 MXML 语法

The <mx:SeriesEffect> tag inherits the tag attributes of its superclass, and adds the following tag attributes:

  <mx:tagname
    Properties
    elementOffset="20"
    minimumElementDuration="0"
    offset="0"
    type="show|hide (Default value is set by chart)"
  >
  


公共属性
 属性定义方
 InheritedclassName : String
[只读 (read-only)] 效果类的名称,如“Fade”。
Effect
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcustomFilter : EffectTargetFilter
指定一个 EffectTargetFilter 类型的自定义滤镜对象,效果将使用此对象来确定播放效果的目标。
Effect
 Inheritedduration : Number
效果的持续时间(以毫秒为单位)。
Effect
 InheritedeasingFunction : Function = null
动画的缓动函数。
TweenEffect
 InheritedeffectTargetHost : IEffectTargetHost
一个属性,您可以通过设置此属性访问数据效果基于列表的目标控件。
Effect
  elementOffset : Number = 20
指定 Flex 延迟效果开始作用于系列中各元素的时间量(以毫秒为单位)。
SeriesEffect
 Inheritedfilter : String
指定用于过滤效果目标的算法。
Effect
 InheritedhideFocusRing : Boolean
确定在开始播放效果时,效果是否应隐藏对焦环。
Effect
 InheritedinstanceClass : Class
一个 Class 类型的对象,用于指定此效果类的效果实例类。
Effect
 InheritedisPlaying : Boolean
[只读 (read-only)] 一个只读标志,如果当前正在播放效果的任一实例,则为 true;否则,则为 false。
Effect
  minimumElementDuration : Number = 0
指定单个元素完成效果所需的时间量(以毫秒为单位)。
SeriesEffect
  offset : Number = 0
指定 Flex 延迟效果的时间量(以毫秒为单位)。
SeriesEffect
 InheritedperElementOffset : Number
在效果的第一个目标之后,其它效果目标的附加延迟(以毫秒为单位)。
Effect
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
 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
要应用此效果的 UIComponent 对象。
Effect
 Inheritedtargets : Array
一个 UIComponent 对象 Array,这些对象都是效果的目标。
Effect
 InheritedtriggerEvent : Event
如果触发了某个效果,则此项目是由 EffectManager 传递给此 Effect 的 Event 对象;如果 EffectManager 当前没有播放此效果,则为 null。
Effect
  type : String = "show"
此效果适用的过渡类型。
SeriesEffect
受保护的属性
 属性定义方
 InheritedendValuesCaptured : Boolean = false
一个标志,如果已确定效果的结束值,则该标志中包含 true;如果需要在效果运行时从效果目标的当前属性捕获这些值,则其中包含 false。
Effect
公共方法
 方法定义方
  
构造函数。
SeriesEffect
 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
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
受保护的方法
 方法定义方
 Inherited
applyValueToTarget(target:Object, property:String, value:*, props:Object):void
供 Effect 基础结构内部使用。
Effect
 Inherited
当效果实例完成播放时调用。
Effect
 Inherited
当效果实例开始播放时调用此方法。
Effect
 Inherited
filterInstance(propChanges:Array, target:Object):Boolean
确定筛选效果实例所用的逻辑。
Effect
 Inherited
getValueFromTarget(target:Object, property:String):*
由 captureStartValues() 方法调用,用来从目标获得某个属性的值。
Effect
 Inherited
将效果的属性复制到效果实例。
Effect
 Inherited
当 TweenEffect 调度 TweenEvent 时调用此方法。
TweenEffect
事件
 事件 摘要 定义方
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
 Inherited当效果完成播放时(既可以是效果实际完成播放时,也可以是通过调用 end() 方法中断效果时)调度。Effect
 Inherited当效果开始播放时调度。Effect
 Inherited当补间效果结束时调度。TweenEffect
 Inherited当开始播放补间效果时调度此事件,相当于首次调用 onTweenUpdate() 方法。TweenEffect
 Inherited每当补间效果更新目标时调度。TweenEffect
属性详细信息
elementOffset属性
public var elementOffset:Number = 20

指定 Flex 延迟效果开始作用于系列中各元素的时间量(以毫秒为单位)。

elementOffset 设置为 0 可同时作用于系列中的所有元素。效果作用于这些元素的开始时间和结束时间相同。

elementOffset 设置为正整数(如 30)可按该时间量将该效果交错作用于各个元素。例如,对于滑动效果,第一个元素立即滑动,下一个元素在 30 毫秒之后开始滑动,依此类推。每个元素执行效果的时间量都是相同的,但效果的整体持续时间将会延长。

elementOffset 设置为负值可使效果从最后一个元素开始起作用,并在列表中逆向移动。

默认值为 20

minimumElementDuration属性 
public var minimumElementDuration:Number = 0

指定单个元素完成效果所需的时间量(以毫秒为单位)。

系列中数据点数可变的图表仅通过 duration 属性可能无法创建平滑的效果。例如,如果系列中包含两个元素,则对于将 duration 设置为 1000,以及将 elementOffset 设置为 100 的效果,每个元素需要 900 毫秒来完成此效果。这是因为每个效果的起始点都偏移了 100,并且都要在 1000 毫秒内完成。

如果系列中包含四个元素,则每个元素需要 700 毫秒来完成此效果(最后一个效果将在第一个效果完成 300 毫秒后启动,并且必须在 1000 毫秒内完成)。如果包含 10 个元素,则每个元素只有 100 毫秒的时间

来完成效果。

minimumElementDuration 值设置了每个元素的最短持续时间。无论系列中包含多少元素以及 duration 属性的值如何设置,系列中任何元素执行此效果的时间量(以毫秒为单位)都不能少于此值。因此,如果指定了 durationoffsetminimumElementDuration 中的任意两个属性,则执行效果所需的时间就可能长于指定的 duration

默认值为 0

offset属性 
public var offset:Number = 0

指定 Flex 延迟效果的时间量(以毫秒为单位)。

使用此属性在多个系列上交错执行多个效果。

默认值为 0

type属性 
public var type:String = "show"

此效果适用的过渡类型。根据将要应用于图表过渡过程的显示阶段还是隐藏阶段,某些系列效果定义了不同的行为。例如,当此属性设置为 hide 时,SeriesSlide 效果会使元素从自身位置滑离屏幕;当此属性设置为 show 时,元素将在屏幕上滑动。此属性由图表根据将此效果分配给了 ShowDataEffect 还是 HideDataEffect 样式来设置。

构造函数详细信息
SeriesEffect()构造函数
public function SeriesEffect(target:Object)

构造函数。

参数
target:Object — 效果的目标。