Adobe® Flex® 4 Language Reference
Hide Packages and Classes List |  Packages  |  Classes  |  Index  |  Appendixes
mx.charts.effects.effectClasses 
SeriesZoomInstance 
Packagemx.charts.effects.effectClasses
Classpublic class SeriesZoomInstance
InheritanceSeriesZoomInstance Inheritance SeriesEffectInstance Inheritance TweenEffectInstance Inheritance EffectInstance Inheritance EventDispatcher Inheritance Object

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

The SeriesZoomInstance class implements the instance class for the SeriesZoom effect. Flex creates an instance of this class when it plays a SeriesZoom effect; you do not create one yourself.

See also



Public Properties
 PropertyDefined By
 InheritedclassName : String
[read-only] The name of the effect class, such as "FadeInstance".
EffectInstance
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 Inheritedduration : Number
The duration of the effect, in milliseconds.
EffectInstance
 InheritedeasingFunction : Function
The easing function for the animation.
TweenEffectInstance
 Inheritedeffect : IEffect
The IEffect object that created this IEffectInstance object.
EffectInstance
 InheritedeffectTargetHost : mx.effects:IEffectTargetHost
A property that lets you access the target list-based control of a data effect.
EffectInstance
 InheritedelementOffset : Number = 20
Specifies the amount of time, in milliseconds, that Flex delays the start of the effect on each element in the series.
SeriesEffectInstance
 InheritedhideFocusRing : Boolean
Determines whether the effect should hide the focus ring when starting the effect.
EffectInstance
  horizontalFocus : String
Defines the location of the focul point of the zoom.
SeriesZoomInstance
 InheritedminimumElementDuration : Number = 0
Specifies the amount of time, in milliseconds, that an individual element should take to complete the effect.
SeriesEffectInstance
 Inheritedoffset : Number = 0
Specifies the amount of time, in milliseconds, that Flex delays the effect.
SeriesEffectInstance
 InheritedplayheadTime : Number
[override] Current time position of the effect.
TweenEffectInstance
 InheritedpropertyChanges : PropertyChanges
Specifies the PropertyChanges object containing the start and end values for the set of properties relevant to the effect's targets.
EffectInstance
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  relativeTo : String = "series"
Controls the bounding box that Flex uses to calculate the focal point of the zooms.
SeriesZoomInstance
 InheritedrepeatCount : int
Number of times to repeat the effect.
EffectInstance
 InheritedrepeatDelay : int
Amount of time, in milliseconds, to wait before repeating the effect.
EffectInstance
 InheritedstartDelay : int
Amount of time, in milliseconds, to wait before starting the effect.
EffectInstance
 InheritedsuspendBackgroundProcessing : Boolean
If true, blocks all background processing while the effect is playing.
EffectInstance
 Inheritedtarget : Object
The UIComponent object to which this effect is applied.
EffectInstance
 InheritedtriggerEvent : Event
The event, if any, which triggered the playing of the effect.
EffectInstance
 Inheritedtween : mx.effects:Tween
The Tween object, which determines the animation.
TweenEffectInstance
 Inheritedtype : String = "show"
The type of transition this effect is being used for.
SeriesEffectInstance
  verticalFocus : String
Defines the location of the focul point of the zoom.
SeriesZoomInstance
Protected Properties
 PropertyDefined By
 InheritedinterpolationValues : Array
The current position of each chart item being managed by this effect.
SeriesEffectInstance
 InheritedplayCount : int = 0
Number of times that the instance has been played.
EffectInstance
 InheritedtargetSeries : Series
The series targeted by this instance.
SeriesEffectInstance
Public Methods
 MethodDefined By
  
Constructor.
SeriesZoomInstance
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
EventDispatcher
 Inherited
Dispatches an event into the event flow.
EventDispatcher
 Inherited
[override] Interrupts an effect that is currently playing, and immediately jumps to the end of the effect.
TweenEffectInstance
 Inherited
Called by the end() method when the effect finishes playing.
EffectInstance
 Inherited
Called after each iteration of a repeated effect finishes playing.
EffectInstance
 Inherited
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
EventDispatcher
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
This method is called if the effect was triggered by the EffectManager.
EffectInstance
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Callback method that is called when the target should be updated by the effect for the last time.
TweenEffectInstance
 Inherited
Callback method that is called when the target should be updated by the effect.
TweenEffectInstance
 Inherited
Pauses the effect until you call the resume() method.
EffectInstance
 Inherited
Plays the effect instance on the target.
EffectInstance
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
EventDispatcher
 Inherited
Resumes the effect after it has been paused by a call to the pause() method.
EffectInstance
 Inherited
Plays the effect in reverse, starting from the current position of the effect.
EffectInstance
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Plays the effect instance on the target after the startDelay period has elapsed.
EffectInstance
 Inherited
Stops the effect, leaving the target in its current state.
EffectInstance
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
 Inherited
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
EventDispatcher
Protected Methods
 MethodDefined By
 Inherited
beginTween(elementCount:int):void
Initializes the tweening calculations and sets up the interpolationValues Array for the number of items equal to the elementCount property.
SeriesEffectInstance
 Inherited
createTween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1):mx.effects:Tween
Creates a Tween instance, assigns it the start, end, and duration values.
TweenEffectInstance
Events
 Event Summary Defined By
 Inherited[broadcast event] Dispatched when the Flash Player or AIR application gains operating system focus and becomes active.EventDispatcher
 Inherited[broadcast event] Dispatched when the Flash Player or AIR application operating loses system focus and is becoming inactive.EventDispatcher
Property Detail

horizontalFocus

property
public var horizontalFocus:String

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Defines the location of the focul point of the zoom.

Valid values of horizontalFocus are "left", "center", "right", and null.

The default value is "center".

You combine the horizontalFocus and verticalFocus properties to define where the data series zooms in and out from. For example, set horizontalFocus to "left" and verticalFocus to "top" to zoom the series data to and from the top left corner of either the element or the chart (depending on the setting of the relativeTo property).

If you specify only one of these two properties, then the focus is a horizontal or vertical line rather than a point. For example, when you set horizontalFocus to "left" but verticalFocus to null, the element zooms to and from a vertical line along the left edge of its bounding box. Set verticalFocus to "center" to zoom chart elements to and from a horizontal line along the middle of the chart's bounding box.

relativeTo

property 
public var relativeTo:String = "series"

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Controls the bounding box that Flex uses to calculate the focal point of the zooms.

Valid values for relativeTo are "series" and "chart". The default value is "series".

Set to "series" to zoom each element relative to itself. For example, each column of a ColumnChart zooms from the top left of the column, the center of the column, and so on.

Set to "chart" to zoom each element relative to the chart area. For example, each column zooms from the top left of the axes, the center of the axes, and so on.

verticalFocus

property 
public var verticalFocus:String

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Defines the location of the focul point of the zoom.

Valid values of verticalFocus are "top", "center", "bottom", and null. The default value is "center".

For more information, see the description of the horizontalFocus property.

Constructor Detail

SeriesZoomInstance

()Constructor
public function SeriesZoomInstance(target:Object)

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Constructor.

Parameters
target:Object — The target of the effect.