mx.charts.effects.effectClasses.SeriesEffectInstance (Flex 3.2)

公共属性

	属性		定义方
		className : String [只读 (read-only)] 效果类的名称，如“FadeInstance”。	EffectInstance
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		duration : Number 效果的持续时间（以毫秒为单位）。	EffectInstance
		easingFunction : Function 动画的缓动函数。	TweenEffectInstance
		effect : IEffect 创建此 IEffectInstance 对象的 IEffect 对象。	EffectInstance
		effectTargetHost : IEffectTargetHost 一个属性，您可以通过设置此属性访问数据效果基于列表的目标控件。	EffectInstance
		elementOffset : Number = 20 指定 Flex 延迟效果开始作用于系列中各元素的时间量（以毫秒为单位）。	SeriesEffectInstance
		hideFocusRing : Boolean 确定在开始播放效果时，效果是否应隐藏对焦环。	EffectInstance
		minimumElementDuration : Number = 0 指定单个元素完成效果所需的时间量（以毫秒为单位）。	SeriesEffectInstance
		offset : Number = 0 指定 Flex 延迟效果的时间量（以毫秒为单位）。	SeriesEffectInstance
		playheadTime : Number [只读 (read-only)] 效果的当前位置（以毫秒为单位）。	TweenEffectInstance
		propertyChanges : PropertyChanges 指定包含一组属性的初始值和结束值的 PropertyChanges 对象，这些属性与效果的目标相关。	EffectInstance
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		repeatCount : int 效果的重复次数。	EffectInstance
		repeatDelay : int 重复播放效果前需要等待的时间（以毫秒为单位）。	EffectInstance
		startDelay : int 开始播放效果前需要等待的时间（以毫秒为单位）。	EffectInstance
		suspendBackgroundProcessing : Boolean 如果为 true，则在播放效果时阻止所有背景处理。	EffectInstance
		target : Object 要应用此效果的 UIComponent 对象。	EffectInstance
		triggerEvent : Event 触发播放效果的事件（如果有）。	EffectInstance
		tween : Tween 用于确定动画的 Tween 对象。	TweenEffectInstance
		type : String = "show" 此效果适用的过渡类型。	SeriesEffectInstance

	属性	定义方
		interpolationValues : Array 受此效果管理的各个图表项目的当前位置。	SeriesEffectInstance
		targetSeries : Series 此实例的目标系列。	SeriesEffectInstance

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		定义方
		SeriesEffectInstance(target:Object = null) 构造函数。	SeriesEffectInstance
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		end():void 中断当前播放的效果，并立即跳至该效果的结尾。	TweenEffectInstance
		finishEffect():void 在完成效果播放时由 end() 方法调用。	EffectInstance
		finishRepeat():void 每次完成重复效果的迭代播放后调用。	EffectInstance
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		initEffect(event:Event):void 如果由 EffectManager 触发效果，则会调用此方法。	EffectInstance
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		onTweenEnd(value:Object):void 当效果应最后一次更新目标时调用的回调方法。	TweenEffectInstance
		onTweenUpdate(value:Object):void 当效果应更新目标时调用的回调方法。	TweenEffectInstance
		pause():void 暂停效果，直到调用 resume() 方法。	EffectInstance
		play():void 在目标上播放效果实例。	EffectInstance
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		resume():void 在效果由 pause() 方法暂停后继续播放效果。	EffectInstance
		reverse():void 从效果的当前位置开始反向播放效果。	EffectInstance
		seek(playheadTime:Number):void 将效果前移到指定位置。	TweenEffectInstance
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		startEffect():void 经过 startDelay 所占用的这段时间后，在目标上播放效果实例。	EffectInstance
		stop():void 停止播放效果，使目标保持当前状态。	EffectInstance
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

	方法	定义方
		beginTween(elementCount:int):void 初始化补间计算，并建立项目数与 elementCount 属性相等的 interpolationValues Array。	SeriesEffectInstance
		createTween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1):Tween 创建一个 Tween 实例，为其分配开始值、结束值和持续时间值。	TweenEffectInstance

	事件	摘要	定义方
		activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
		deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher

属性详细信息

elementOffset

属性

public var elementOffset:Number = 20

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

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

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

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

默认值为 20。

interpolationValues

属性

protected var interpolationValues:Array

受此效果管理的各个图表项目的当前位置。这是一个介于 0 和 1 之间的值的数组，指示此效果应将系列中各个项目显示到该数组的起始值和结束值之间的一个什么程度。这些值是根据持续时间、元素数目、元素偏移量、最小元素持续时间以及缓动函数计算的。

minimumElementDuration

属性

public var minimumElementDuration:Number = 0

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

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

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

来完成效果。

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

默认值为 0。

offset

属性

public var offset:Number = 0

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

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

默认值为 0。

targetSeries

属性

protected var targetSeries:Series

此实例的目标系列。

type

属性

public var type:String = "show"

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

构造函数详细信息

SeriesEffectInstance

()

构造函数

public function SeriesEffectInstance(target:Object = null)

构造函数。

参数

target:Object (default = null) — 效果的目标。

方法详细信息

beginTween

()

方法

protected function beginTween(elementCount:int):void

初始化补间计算，并建立项目数与 elementCount 属性相等的 interpolationValues Array。派生的类应在其 play() 方法中调用此函数。

参数

elementCount:int — 需要生成 interpolation 值的元素数。

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
SeriesEffectInstance	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例

包	mx.charts.effects.effectClasses
类	public class SeriesEffectInstance
继承	SeriesEffectInstance TweenEffectInstance EffectInstance EventDispatcher Object
子类	SeriesInterpolateInstance, SeriesSlideInstance, SeriesZoomInstance