Duration of the transition, in milliseconds. The default may vary depending on the transition but is defined in ViewTransitionBase as 250 ms.

The easing behavior for this transition. The IEaser object is generally propagated to the IEffect instance managing the actual transition animation.

The default value is Sine(.5);.

Related API Elements

The view that the navigator is transitioning to, as set by the owning ViewNavigator object. This property can be null.

The default value is null.

Reference to the owning ViewNavigator instance set by the owning ViewNavigator.

The default value is null.

The currently active view of the view navigator, as set by the owning view navigator. This property can be null.

When set to true, the UIComponent.suspendBackgroundProcessing() method is invoked prior to the transition playing. This disables Flex's layout manager and improving performance. Upon completion of the transition, the layout manager function is restored by a call to the UIComponent.resumeBackgroundProcessing() method.

The default value is false.

Related API Elements

When set to true, the primary view transition is used to transition the view navigator in its entirety, including the action bar. Specific transitions for the action bar are not performed. Because the tab bar is associated with the entire application, and not a view, view transitions do not affect it.

Note that even when set to false, there are cases where its not feasible to transition the action bar. For example, when the action bar does not exist in one of the two views, or if the action bar changes size.

The default value is false.

Constructor.

Determine if Flex can perform a transition on action bar or tab bar content independently of the views.

Flex cannot perform a transition on the control bars independently:

• If the containing view navigator is a TabbedViewNavigator and its tab bar's visibility changes between views.
• If the value of the view navigator's overlayControls property changes between views.
• If the size or visibility of the action bar changes between views.

Called by the ViewNavigator during the preparation phase of a transition. It is invoked when the new view has been fully realized and validated and the action bar and tab bar content reflect the state of the new view. It is at this point that the transition can capture any values it requires from the pending view. In addition any bitmaps reflecting the state of the new view, tab bar, or action bar should be captured, if required for animation.

Called by the ViewNavigator during the preparation phase of a transition. It is invoked when the new view has been fully realized and validated and the action bar and tab bar content reflect the state of the new view. The transition can use this method capture any values it requires from the pending view. Any bitmaps reflecting the state of the new view, tab bar, or action bar should be captured if required for animation.

Called after the transition completes. This method is responsible for releasing any references and temporary constructs used by the transition.

Called by the default prepareForPlay() implementation, this method is responsible for creating the Spark effect played on the action bar when the transition starts. This method should be overridden by subclasses if a custom action bar effect is required. By default, this method returns a basic action bar effect.

Called by the default prepareForPlay() implementation, this method is responsible for creating the Spark effect played to transition the entire navigator, inclusive of the control bar content, when necessary. This method should be overridden by subclasses. By default, this method returns null.

Called by the default prepareForPlay() implementation, this method is responsible for creating the Spark effect played on the tab bar when the transition starts. This method should be overridden by subclasses. By default, this returns null.

Called by the default prepareForPlay() implementation, this method is responsible for creating the Spark effect played on the current and next view when the transition starts. This method should be overridden by subclasses. By default, this method returns null.

Used to render snap shots of screen elements in preparation for transitioning. The bitmap is returned in the form of a BitmapImage object.

The BitmapImage is in target's parent coordiantes space - it overlaps the target precisely if paranted to the same parent. When moving to a different parent, make sure to adjust the transformation of the BitmapImage to correctly account for the change in coordinate spaces. The updated value of the globalPosition parameter can be used for that.

Parameters

Called by the ViewNavigator when the transition should begin animating. At this time, the transition should dispatch a start event.

Called by the ViewNavigator during the preparation phase of a transition. This method gives the transition the chance to create and configure the underlying IEffect instance, or to add any transient elements to the display list. Example transient elements include bitmap placeholders, temporary containers required during the transition, and other elements. If required, a final validation pass occurs prior to the invocation of the play() method.

If it is determined that a standard transition can be initiated, meaning one that transitions the control bars separately from the views, the default implementation of this method constructs a single Parallel effect which wraps the individual effect sequences for the view transition, the action bar transition, and the tab bar transition. This method uses the methods, createActionBarEffect(), createTabBarEffect(), and createViewEffect().

If transitionControlsWithContent is set to true, or if it is determined that the control bars cannot be transitioned independently, a single effect is created to transition the navigator in its entirety. In this case, only createConsolidatedEffect() is invoked.

Called by the transition to indicate that the transition has completed. This method dispatches the end event.

Dispatched when the transition completes.

This event will only be dispatched when there are one or more relevant listeners attached to the dispatching object.

The properties of the event object have the following values:

Dispatched when the transition starts.

This event will only be dispatched when there are one or more relevant listeners attached to the dispatching object.

The properties of the event object have the following values: