| Pakiet | spark.transitions |
| Klasa | public class ViewTransitionBase |
| Dziedziczenie | ViewTransitionBase  EventDispatcher Object |
| Podklasy | CrossFadeViewTransition, FlipViewTransition, SlideViewTransition, ZoomViewTransition |
| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
When a view transition is initialized, the owning view navigator
sets the startView and endView properties
to the views the transition animates.
The navigator property is
set to the view navigator.
The lifecycle of a transition is as follows:
- The transition starts with
the
captureStartValues()method. When this method is called, the navigator is currently in the start state. At this time, the transition should capture any start values or bitmaps that it requires. - A validation pass is performed on the pending
view, and the
captureEndValues()method is called. At this time, the transition captures any properties or bitmaps representations from the pending view. - The
prepareForPlay()method is then called, which allows the transition to perform any further preparations, such as preparing a Spark effects sequence, or positioning transient elements on the display list. - After a final validation pass, if necessary,
the
play()method is called by the navigator to perform the actual transition. - Prior to any animation starting, the
startevent is dispatched. - When a transition completes, it dispatches an
endevent.
Note:Create and configure view transitions in ActionScript; you cannot create them in MXML.
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| duration : Number
Duration of the transition, in milliseconds. | ViewTransitionBase | ||
| easer : IEaser
The easing behavior for this transition. | ViewTransitionBase | ||
| endView : View
The view that the navigator is transitioning
to, as set by the owning ViewNavigator object. | ViewTransitionBase | ||
| navigator : ViewNavigator
Reference to the owning ViewNavigator instance set by the owning
ViewNavigator. | ViewTransitionBase | ||
| startView : View
The currently active view of the view navigator,
as set by the owning view navigator. | ViewTransitionBase | ||
| suspendBackgroundProcessing : Boolean
When set to true, the UIComponent.suspendBackgroundProcessing()
method is invoked prior to the transition playing. | ViewTransitionBase | ||
| transitionControlsWithContent : Boolean
When set to true, the primary view transition
is used to transition the view navigator in its entirety,
including the action bar. | ViewTransitionBase | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Constructor. | ViewTransitionBase | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | |
Called by the ViewNavigator during the preparation phase of a transition. | ViewTransitionBase | ||
Called by the ViewNavigator during the preparation phase of a transition. | ViewTransitionBase | ||
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | |
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
Called by the ViewNavigator when the transition
should begin animating. | ViewTransitionBase | ||
Called by the ViewNavigator during the preparation phase
of a transition. | ViewTransitionBase | ||
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
|
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher | |
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Determine if Flex can perform a transition on
action bar or tab bar content independently of the views. | ViewTransitionBase | ||
Called after the transition completes. | ViewTransitionBase | ||
Called by the default prepareForPlay() implementation,
this method is responsible for creating the Spark effect
played on the action bar when the transition starts. | ViewTransitionBase | ||
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. | ViewTransitionBase | ||
Called by the default prepareForPlay() implementation,
this method is responsible for creating the Spark effect played
on the tab bar when the transition starts. | ViewTransitionBase | ||
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. | ViewTransitionBase | ||
Used to render snap shots of screen elements in
preparation for transitioning. | ViewTransitionBase | ||
Called by the transition to indicate that the transition
has completed. | ViewTransitionBase | ||
| Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
|---|---|---|---|---|
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | ||
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | ||
| Dispatched when the transition completes. | ViewTransitionBase | |||
| Dispatched when the transition starts. | ViewTransitionBase | |||
duration | właściwość |
duration:Number| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Duration of the transition, in milliseconds. The default may vary depending on the transition but is defined in ViewTransitionBase as 250 ms.
Implementacja
public function get duration():Number public function set duration(value:Number):void easer | właściwość |
easer:IEaser| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
The easing behavior for this transition. The IEaser object is generally propagated to the IEffect instance managing the actual transition animation.
Wartością domyślną jest Sine(.5);.
Implementacja
public function get easer():IEaser public function set easer(value:IEaser):voidPowiązane elementy interfejsu API
endView | właściwość |
endView:View| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
The view that the navigator is transitioning to, as set by the owning ViewNavigator object. This property can be null.
Wartością domyślną jest null.
Implementacja
public function get endView():View public function set endView(value:View):void navigator | właściwość |
navigator:ViewNavigator| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Reference to the owning ViewNavigator instance set by the owning ViewNavigator.
Wartością domyślną jest null.
Implementacja
public function get navigator():ViewNavigator public function set navigator(value:ViewNavigator):void startView | właściwość |
startView:View| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
The currently active view of the view navigator, as set by the owning view navigator. This property can be null.
Implementacja
public function get startView():View public function set startView(value:View):void suspendBackgroundProcessing | właściwość |
suspendBackgroundProcessing:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
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.
Wartością domyślną jest false.
Implementacja
public function get suspendBackgroundProcessing():Boolean public function set suspendBackgroundProcessing(value:Boolean):voidPowiązane elementy interfejsu API
transitionControlsWithContent | właściwość |
transitionControlsWithContent:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
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.
Wartością domyślną jest false.
Implementacja
public function get transitionControlsWithContent():Boolean public function set transitionControlsWithContent(value:Boolean):void ViewTransitionBase | () | Konstruktor |
public function ViewTransitionBase()| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Constructor.
canTransitionControlBarContent | () | metoda |
protected function canTransitionControlBarContent():Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
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
overlayControlsproperty changes between views. - If the size or visibility of the action bar changes between views.
Boolean — false if Flex determines controls bars between views are
incompatible in some way.
|
captureEndValues | () | metoda |
public function captureEndValues():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
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.
captureStartValues | () | metoda |
public function captureStartValues():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
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.
cleanUp | () | metoda |
protected function cleanUp():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Called after the transition completes. This method is responsible for releasing any references and temporary constructs used by the transition.
createActionBarEffect | () | metoda |
protected function createActionBarEffect():IEffect| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
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.
IEffect — An IEffect instance serving as the action bar effect.
This effect is played by the default play() method implementation.
|
createConsolidatedEffect | () | metoda |
protected function createConsolidatedEffect():IEffect| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
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.
IEffect — An IEffect instance serving as the view transition.
This effect is played by the default play() method implementation.
|
createTabBarEffect | () | metoda |
protected function createTabBarEffect():IEffect| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
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.
IEffect — An IEffect instance serving as the tab bar transition.
This effect is played by the default play() method implementation.
|
createViewEffect | () | metoda |
protected function createViewEffect():IEffect| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
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.
IEffect — An IEffect instance serving as the view transition.
This effect is played by the default play() method implementation.
|
getSnapshot | () | metoda |
protected function getSnapshot(target:UIComponent, padding:int = 4, globalPosition:Point = null):BitmapImage| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
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.
Parametry
target:UIComponent — Display object to capture.
| |
padding:int (default = 4) | |
globalPosition:Point (default = null)globalPosition
will be updated with the origin of the BitmapImage in global
coordiantes. When moving to a different coordinate space, this
value can be used to adjust the snapshot's position so its
global position on screen doesn't change.
|
BitmapImage — BitmapImage object representing the target.
|
play | () | metoda |
public function play():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Called by the ViewNavigator when the transition
should begin animating.
At this time, the transition should dispatch a
start event.
prepareForPlay | () | metoda |
public function prepareForPlay():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
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.
transitionComplete | () | metoda |
protected function transitionComplete():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Called by the transition to indicate that the transition
has completed.
This method dispatches the end event.
transitionEnd | Zdarzenie |
mx.events.FlexEventwłaściwość FlexEvent.type =
mx.events.FlexEvent.TRANSITION_START| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Dispatched when the transition completes.
TheFlexEvent.TRANSITION_START constant defines the value of the
type property of the event object for a transitionStart event.
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:
| Property | Value |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | The Object that defines the
event listener that handles the event. For example, if you use
myButton.addEventListener() to register an event listener,
myButton is the value of the currentTarget. |
target | The Object that dispatched the event;
it is not always the Object listening for the event.
Use the currentTarget property to always access the
Object listening for the event. |
transitionStart | Zdarzenie |
mx.events.FlexEventwłaściwość FlexEvent.type =
mx.events.FlexEvent.TRANSITION_START| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 4.5 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Dispatched when the transition starts.
TheFlexEvent.TRANSITION_START constant defines the value of the
type property of the event object for a transitionStart event.
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:
| Property | Value |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | The Object that defines the
event listener that handles the event. For example, if you use
myButton.addEventListener() to register an event listener,
myButton is the value of the currentTarget. |
target | The Object that dispatched the event;
it is not always the Object listening for the event.
Use the currentTarget property to always access the
Object listening for the event. |
Tue Jun 12 2018, 12:06 PM Z