（仅限 Flex 数据可视化组件）
包mx.charts.effects
类public class SeriesZoom
继承SeriesZoom Inheritance SeriesEffect Inheritance TweenEffect Inheritance Effect Inheritance EventDispatcher Inheritance Object

SeriesZoom 效果是将图表数据聚合到您指定的焦点位置，或从该位置分解出图表数据。同 SeriesSlide 效果一样，此效果在该点聚合还是分解取决于将其分配给了 showDataEffect 还是 hideDataEffect 效果触发器。

MXML 语法expanded隐藏 MXML 语法

The <mx:SeriesZoom> tag inherits all the properties of its parent classes, and adds the following properties:

  <mx:SeriesZoom
    Properties
    horizontalFocus="center|left|right|null"
    relativeTo="series|chart"
    verticalFocus="top|center|bottom|null"
  />

查看示例

另请参见

Using effects with charts
Charting effects with data series

公共属性
 属性定义方
 InheritedclassName : String
[只读 (read-only)] 效果类的名称，如“Fade”。
Effect
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcustomFilter : EffectTargetFilter
指定一个 EffectTargetFilter 类型的自定义滤镜对象，效果将使用此对象来确定播放效果的目标。
Effect
 Inheritedduration : Number
效果的持续时间（以毫秒为单位）。
Effect
 InheritedeasingFunction : Function = null
动画的缓动函数。
TweenEffect
 InheritedeffectTargetHost : IEffectTargetHost
一个属性，您可以通过设置此属性访问数据效果基于列表的目标控件。
Effect
 InheritedelementOffset : Number = 20
指定 Flex 延迟效果开始作用于系列中各元素的时间量（以毫秒为单位）。
SeriesEffect
 Inheritedfilter : String
指定用于过滤效果目标的算法。
Effect
 InheritedhideFocusRing : Boolean
确定在开始播放效果时，效果是否应隐藏对焦环。
Effect
  horizontalFocus : String
定义缩放焦点的位置。
SeriesZoom
 InheritedinstanceClass : Class
一个 Class 类型的对象，用于指定此效果类的效果实例类。
Effect
 InheritedisPlaying : Boolean
[只读 (read-only)] 一个只读标志，如果当前正在播放效果的任一实例，则为 true；否则，则为 false。
Effect
 InheritedminimumElementDuration : Number = 0
指定单个元素完成效果所需的时间量（以毫秒为单位）。
SeriesEffect
 Inheritedoffset : Number = 0
指定 Flex 延迟效果的时间量（以毫秒为单位）。
SeriesEffect
 InheritedperElementOffset : Number
在效果的第一个目标之后，其它效果目标的附加延迟（以毫秒为单位）。
Effect
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  relativeTo : String = "series"
控制 Flex 用于计算缩放焦点的边框。
SeriesZoom
 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
 Inheritedtype : String = "show"
此效果适用的过渡类型。
SeriesEffect
  verticalFocus : String
定义缩放焦点的位置。
SeriesZoom
受保护的属性
 属性定义方
 InheritedendValuesCaptured : Boolean = false
一个标志，如果已确定效果的结束值，则该标志中包含 true；如果需要在效果运行时从效果目标的当前属性捕获这些值，则其中包含 false。
Effect
公共方法
 方法定义方
  
SeriesZoom(target:Object = null)
构造函数。
SeriesZoom
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
captureEndValues():void
捕获效果目标上相关属性的当前值，并将这些值另存为结束值。
Effect
 Inherited
captureMoreStartValues(targets:Array):void
捕获另一组目标相关属性的当前值。在运行数据更改效果时，此函数由 Flex 使用。
Effect
 Inherited
captureStartValues():void
捕获效果目标上相关属性的当前值。
Effect
 Inherited
createInstance(target:Object = null):IEffectInstance
创建一个效果实例并对其进行初始化。
Effect
 Inherited
createInstances(targets:Array = null):Array
获取一个目标对象 Array，并对每个目标调用 createInstance() 方法。
Effect
 Inherited
deleteInstance(instance:IEffectInstance):void
删除实例中的事件侦听器，然后从实例列表中删除该实例。
Effect
 Inherited
dispatchEvent(event:Event):Boolean
将事件调度到事件流中。
EventDispatcher
 Inherited
end(effectInstance:IEffectInstance = null):void
中断当前正在播放的效果，立即跳转到该效果的末尾。
Effect
 Inherited
getAffectedProperties():Array
返回一个字符串 Array，其中每个 String 都是被此效果更改的属性名称。
Effect
 Inherited
hasEventListener(type:String):Boolean
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
pause():void
暂停效果，直到调用 resume() 方法。
Effect
 Inherited
play(targets:Array = null, playReversedFromEnd:Boolean = false):Array
开始播放效果。
Effect
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
resume():void
在效果由 pause() 方法暂停后继续播放效果。
Effect
 Inherited
reverse():void
逆序播放效果；如果当前正在播放效果，则从该效果的当前位置开始逆序播放。
Effect
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
 Inherited
stop():void
停止播放效果，使效果目标保持当前状态。
Effect
 Inherited
toString():String
返回指定对象的字符串表示形式。
Object
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
 Inherited
willTrigger(type:String):Boolean
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
受保护的方法
 方法定义方
 Inherited
applyValueToTarget(target:Object, property:String, value:*, props:Object):void
供 Effect 基础结构内部使用。
Effect
 Inherited
effectEndHandler(event:EffectEvent):void
当效果实例完成播放时调用。
Effect
 Inherited
effectStartHandler(event:EffectEvent):void
当效果实例开始播放时调用此方法。
Effect
 Inherited
filterInstance(propChanges:Array, target:Object):Boolean
确定筛选效果实例所用的逻辑。
Effect
 Inherited
getValueFromTarget(target:Object, property:String):*
由 captureStartValues() 方法调用，用来从目标获得某个属性的值。
Effect
 Inherited
initInstance(instance:IEffectInstance):void
将效果的属性复制到效果实例。
Effect
 Inherited
tweenEventHandler(event:TweenEvent):void
当 TweenEffect 调度 TweenEvent 时调用此方法。
TweenEffect
事件
 事件 摘要 定义方
 Inherited
activate
[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited
deactivate
[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
 Inherited
effectEnd
当效果完成播放时（既可以是效果实际完成播放时，也可以是通过调用 end() 方法中断效果时）调度。Effect
 Inherited
effectStart
当效果开始播放时调度。Effect
 Inherited
tweenEnd
当补间效果结束时调度。TweenEffect
 Inherited
tweenStart
当开始播放补间效果时调度此事件，相当于首次调用 onTweenUpdate() 方法。TweenEffect
 Inherited
tweenUpdate
每当补间效果更新目标时调度。TweenEffect
属性详细信息
horizontalFocus属性
public var horizontalFocus:String

定义缩放焦点的位置。

horizontalFocus 属性的有效值为 "left"、"center"、"right" 和 null。

您可以通过组合 horizontalFocus 和 verticalFocus 来定义数据系列的缩放焦点位置。例如，将 horizontalFocus 属性设置为 "left"，并将 verticalFocus 属性设置为 "top" 可在元素或图表的左上角聚合及分解系列数据（取决于 relativeTo 属性的设置）。

如果仅指定了上述任一属性，则焦点将为一条水平线或垂直线，而不是一个点。例如，如果将 horizontalFocus 设置为 "left"，但将 verticalFocus 设置为 null，则将沿边框左边缘的垂直线缩放元素。将 verticalFocus 属性设置为 "center" 可沿图表边框的中部在水平线上聚合及分解图表元素。

默认值为 "center".

relativeTo属性 
public var relativeTo:String = "series"

控制 Flex 用于计算缩放焦点的边框。

relativeTo 属性的有效值为 "series" 和 "chart"。

如果设置为 "series"，则相对于元素本身缩放每个元素。例如，ColumnChart 的每列从该列的左上角或中心等位置进行缩放。

如果设置为 "chart"，则相对于图表区域缩放每个元素。例如，从轴的左上角或中心等位置缩放每一列。

默认值为 "series".

verticalFocus属性 
public var verticalFocus:String

定义缩放焦点的位置。有关详细信息，请参阅 horizontalFocus 属性的说明。

verticalFocus 的有效值为 "top"、"center"、"bottom" 和 null。

默认值为 "center".

构造函数详细信息
SeriesZoom()构造函数
public function SeriesZoom(target:Object = null)

构造函数。

参数
target:Object (default = null)
示例 如何使用示例
SeriesZoomExample.mxml
<?xml version="1.0"?>
<!-- Simple example to demonstrate the CandlestickChart control. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>
        <![CDATA[
          
        import mx.collections.ArrayCollection;

        [Bindable]
        private var companyAAC:ArrayCollection = new ArrayCollection( [
            { Date: "25-Jul", Open: 40.75,  High: 40.75, Low: 40.24, Close:40.31},
            { Date: "26-Jul", Open: 39.98,  High: 40.78, Low: 39.97, Close:40.34},
            { Date: "27-Jul", Open: 40.38,  High: 40.66, Low: 40, Close:40.63},
            { Date: "28-Jul", Open: 40.49,  High: 40.99, Low: 40.3, Close:40.98},
            { Date: "29-Jul", Open: 40.13,  High: 40.4, Low: 39.65, Close:39.95},
            { Date: "1-Aug", Open: 39.00,  High: 39.50, Low: 38.7, Close:38.6}, 
            { Date: "2-Aug", Open: 38.68,  High: 39.34, Low: 37.75, Close:38.84}, 
            { Date: "3-Aug", Open: 38.76,  High: 38.76, Low: 38.03, Close:38.12}, 
            { Date: "4-Aug", Open: 37.98,  High: 37.98, Low: 36.56, Close:36.69},                       
            { Date: "5-Aug", Open: 36.61,  High: 37, Low: 36.48, Close:36.86} ]);

        [Bindable]
        private var companyBAC:ArrayCollection = new ArrayCollection( [
            { Date: "25-Jul", Open: 18.50,  High: 19, Low: 18.48, Close:18.86},
            { Date: "26-Jul", Open: 19.56,  High: 19.98, Low: 18.6, Close:18.69},                       
            { Date: "27-Jul", Open: 20.81,  High: 20.99, Low: 20.03, Close:20.12}, 
            { Date: "28-Jul", Open: 20.70,  High: 21.00, Low: 19.5, Close:20.84}, 
            { Date: "29-Jul", Open: 21.7,  High: 21.79, Low: 20.45, Close:20.6}, 
            { Date: "1-Aug", Open: 22.45,  High: 22.65, Low: 21.65, Close:21.95},
            { Date: "2-Aug", Open: 22.56,  High: 22.6, Low: 22.05, Close:22.98},
            { Date: "3-Aug", Open: 22.42,  High: 22.70, Low: 22.1, Close:22.63},
            { Date: "4-Aug", Open: 21.67,  High: 22.82, Low: 21.67, Close:22.34},
            { Date: "5-Aug", Open: 22.44,  High: 22.85, Low: 22.12, Close:22.31} ]);
        ]]>
    </mx:Script>
    
    <mx:SeriesZoom id="zoomIn" duration="1000"/>
    <mx:SeriesZoom id="zoomOut" duration="1000"/>

    <mx:Panel title="CandlestickChart Control Example" height="100%" width="100%" 
        paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">

        <mx:CandlestickChart id="candlestickchart" height="100%" width="100%"
            paddingRight="5" paddingLeft="5" 
            showDataTips="true" dataProvider="{companyAAC}">
            
            <mx:verticalAxis>
                <mx:LinearAxis id="vaxis" baseAtZero="false" title="Price"/>
            </mx:verticalAxis>

            <mx:horizontalAxis>
                <mx:CategoryAxis id="haxis" categoryField="Date" title="Date"/>
            </mx:horizontalAxis>

            <mx:horizontalAxisRenderers>
                <mx:AxisRenderer axis="{haxis}" canDropLabels="true"/>
            </mx:horizontalAxisRenderers>

            <mx:series>
                <mx:CandlestickSeries  
                    openField="Open" highField="High" 
                    lowField="Low" closeField="Close"
                    showDataEffect="{zoomIn}" 
                    hideDataEffect="{zoomOut}"/>
            </mx:series>
        </mx:CandlestickChart>
        
        <mx:Label width="100%" color="blue"
            text="Choose a company to view recent stock data."/>

        <mx:HBox>
            <mx:RadioButton groupName="stocks" label="View Company A"
                selected="true" click="candlestickchart.dataProvider=companyAAC;"/>
            <mx:RadioButton groupName="stocks" label="View Company B"
                click="candlestickchart.dataProvider=companyBAC;"/>
        </mx:HBox>
    </mx:Panel>
</mx:Application>



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Sun Dec 14 2008, 10:39 PM -08:00