| Package | spark.transitions |
| Classe | public class ViewTransitionBase |
| Héritage | ViewTransitionBase  EventDispatcher Object |
| Sous-classes | CrossFadeViewTransition, FlipViewTransition, SlideViewTransition, ZoomViewTransition |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Lorsqu’une transition de vue est initialisée, le navigateur de vue propriétaire définit les propriétés startView et endView sur les vues que la transition anime. La propriété navigator est définie sur le navigateur de vue.
Le cycle de vie d’une transition se présente comme suit :
- La transition commence avec la
méthode captureStartValues()méthode. Lorsque cette méthode est appelée, le navigateur est actuellement dans l’état de départ. A ce stade, la transition doit capturer toutes les images bitmap ou valeurs de départ dont elle a besoin. - Une validation de transmettre est effectuée sur la vue en attente, et le
captureEndValues()méthode est appelée. A ce stade, la transition capture toutes les propriétés ou représentations d’image bitmap à partir de la vue en attente. - A ce stade, la méthode
prepareForPlay()est appelée, ce qui permet à la transition d’effectuer toute préparation ultérieure (telle que la préparation d’une séquence d’effets Spark ou le positionnement d’éléments transitoires dans la liste d’affichage). - Après une phase finale de validation (si nécessaire), la méthode
play()est appelée par le navigateur pour effectuer la transition réelle. - Avant tout démarrage de l’animation, l’événement
startest distribué. - Lorsqu’une transition se termine, il envoie un
finévénement.
Remarque :créez et configurez les transitions entre les vues dans ActionScript ; vous ne pouvez pas les créer dans MXML.
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| duration : Number
Durée de la transition en millisecondes. | ViewTransitionBase | ||
| easer : IEaser
Le comportement d’accélération de cette transition. | ViewTransitionBase | ||
| endView : View
Vue vers laquelle le navigateur effectue la transition, définie par l’objet ViewNavigator propriétaire lui-même. | ViewTransitionBase | ||
| navigator : ViewNavigator
Référence à l’instance du composant ViewNavigator propriétaire définie par le composant ViewNavigator propriétaire. | ViewTransitionBase | ||
| startView : View
Vue actuellement active du navigateur de vue, définie par le navigateur de vue propriétaire lui-même. | ViewTransitionBase | ||
| suspendBackgroundProcessing : Boolean
Lorsqu’elle est définie sur true, la méthode UIComponent.suspendBackgroundProcessing() est appelée avant la lecture de la transition. | ViewTransitionBase | ||
| transitionControlsWithContent : Boolean
Lorsqu’elle est définie sur true, la transition de la vue principale est utilisée pour effectuer la transition de l’ensemble du navigateur de vue, y compris la barre d’action. | ViewTransitionBase | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | ViewTransitionBase | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
Appelée par le composant ViewNavigator pendant la phase de préparation d’une transition. | ViewTransitionBase | ||
Appelée par le composant ViewNavigator pendant la phase de préparation d’une transition. | ViewTransitionBase | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
Appelée par le composant ViewNavigator lorsque la transition doit commencer l’animation. | ViewTransitionBase | ||
Appelée par le composant ViewNavigator pendant la phase de préparation d’une transition. | ViewTransitionBase | ||
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
| Méthode | Défini par | ||
|---|---|---|---|
Déterminer si Flex peut effectuer une transition sur barre d’action ou barre d’onglets contenu indépendamment des vues. | ViewTransitionBase | ||
Appelée une fois transition terminée. | ViewTransitionBase | ||
Appelée par l’implémentation de la méthode prepareForPlay() par défaut, cette méthode est chargée de créer l’effet Spark qui doit être appliqué à la barre d’action lorsque la transition commence. | ViewTransitionBase | ||
Appelée par l’implémentation de la méthode prepareForPlay() par défaut, cette méthode est chargée de créer l’effet Spark qui est appliqué pour effectuer la transition du navigateur entier (y compris du contenu de la barre de contrôle) lorsque cela est nécessaire. | ViewTransitionBase | ||
Appelée par l’implémentation de la méthode prepareForPlay() par défaut, cette méthode est chargée de créer l’effet Spark qui doit être appliqué à la barre d’onglets lorsque la transition commence. | ViewTransitionBase | ||
Appelée par l’implémentation de la méthode prepareForPlay() par défaut, cette méthode est chargée de créer l’effet Spark qui est appliqué à la vue actuelle et à la vue suivante lorsque la transition commence. | ViewTransitionBase | ||
Permet d’effectuer le rendu d’instantanés des éléments d’écran en phase de préparation pour la transition. | ViewTransitionBase | ||
Appelée par la transition pour indiquer que la transition est terminée. | ViewTransitionBase | ||
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué lorsque la transaction se termine. | ViewTransitionBase | |||
| Distribuée lorsque la transition commence. | ViewTransitionBase | |||
duration | propriété |
duration:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Durée de la transition en millisecondes. La valeur par défaut peut varier selon la transition, mais est définie dans ViewTransitionBase sur 250 ms.
Implémentation
public function get duration():Number public function set duration(value:Number):void easer | propriété |
easer:IEaser| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Le comportement d’accélération de cette transition. l’objet IEaser est généralement propagé à l’instance de IEffect qui gère l’animation de la transition réelle.
La valeur par défaut est Sine(.5);.
Implémentation
public function get easer():IEaser public function set easer(value:IEaser):voidEléments de l’API associés
endView | propriété |
endView:View| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Vue vers laquelle le navigateur effectue la transition, définie par l’objet ViewNavigator propriétaire lui-même. Cette propriété peut être de valeur null.
La valeur par défaut est null.
Implémentation
public function get endView():View public function set endView(value:View):void navigator | propriété |
navigator:ViewNavigator| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Référence à l’instance du composant ViewNavigator propriétaire définie par le composant ViewNavigator propriétaire.
La valeur par défaut est null.
Implémentation
public function get navigator():ViewNavigator public function set navigator(value:ViewNavigator):void startView | propriété |
startView:View| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Vue actuellement active du navigateur de vue, définie par le navigateur de vue propriétaire lui-même. Cette propriété peut être de valeur null.
Implémentation
public function get startView():View public function set startView(value:View):void suspendBackgroundProcessing | propriété |
suspendBackgroundProcessing:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Lorsqu’elle est définie sur true, la méthode UIComponent.suspendBackgroundProcessing() est appelée avant la lecture de la transition. Cette action désactive Flex du gestionnaire de mise en page et amélioration des performances. A la fin de la transition, le gestionnaire de mise en page fonction est restaurée par un appel à la UIComponent.resumeBackgroundProcessing() méthode.
La valeur par défaut est false.
Implémentation
public function get suspendBackgroundProcessing():Boolean public function set suspendBackgroundProcessing(value:Boolean):voidEléments de l’API associés
transitionControlsWithContent | propriété |
transitionControlsWithContent:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Lorsqu’elle est définie sur true, la transition de la vue principale est utilisée pour effectuer la transition de l’ensemble du navigateur de vue, y compris la barre d’action. Les transitions spécifique à la barre d’action ne sont pas exécutées. Etant donné que la barre d’onglets est associée à l’intégralité de l’application, et non à une vue, les transitions entre les vues n’ont pas d’incidence.
Notez que même lorsqu’elle est définie sur false, il existe des cas où il n’est pas possible d’exécuter la transition de la barre d’action. Par exemple, lorsque la barre d’action n’est pas présente dans l’une des deux vues, ou si la taille de la barre d’action change.
La valeur par défaut est false.
Implémentation
public function get transitionControlsWithContent():Boolean public function set transitionControlsWithContent(value:Boolean):void ViewTransitionBase | () | Constructeur |
public function ViewTransitionBase()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Constructeur.
canTransitionControlBarContent | () | méthode |
protected function canTransitionControlBarContent():Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Déterminer si Flex peut effectuer une transition sur barre d’action ou barre d’onglets contenu indépendamment des vues.
Flex ne peut pas effectuer une transition sur le contrôle barres indépendamment les unes des autres :
- Si la vue contenant navigator est un TabbedViewNavigator et sa barre d’onglets sa visibilité change entre les vues.
- Si la valeur de l’affichage du navigateur
overlayControlspropriété les modifications effectuées entre les vues. - Si la taille ou la visibilité de la barre d’action change entre les vues.
Boolean — false si Flex détermine que les barres de contrôle entre les vues sont incompatibles d’une certaine manière.
|
captureEndValues | () | méthode |
public function captureEndValues():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Appelée par le composant ViewNavigator pendant la phase de préparation d’une transition. Elle est appelée lorsque la nouvelle vue a été entièrement réalisée et validée, et que le contenu de la barre d’action et de la barre d’onglets reflète l’état de la nouvelle vue. A ce stade, la transition peut capturer toutes les valeurs dont elle a besoin à partir de la vue en attente. En outre, toute image bitmap reflétant l’état de la nouvelle vue, barre d’onglets ou barre d’action, doit être capturée si elle est requise pour l’animation.
captureStartValues | () | méthode |
public function captureStartValues():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Appelée par le composant ViewNavigator pendant la phase de préparation d’une transition. Elle est appelée lorsque la nouvelle vue a été entièrement réalisée et validée, et que le contenu de la barre d’action et de la barre d’onglets reflète l’état de la nouvelle vue. La transition peut utiliser cette méthode pour capturer les valeurs doit elle a besoin à partir de la vue en attente. Toute image bitmap reflétant l’état de la nouvelle vue, barre d’onglets ou barre d’action, doit être capturée si elle est requise pour l’animation.
cleanUp | () | méthode |
protected function cleanUp():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Appelée une fois transition terminée. Cette méthode est chargée de libérer toutes les références et les constructions temporaires utilisées par la transition.
createActionBarEffect | () | méthode |
protected function createActionBarEffect():IEffect| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Appelée par l’implémentation de la méthode prepareForPlay() par défaut, cette méthode est chargée de créer l’effet Spark qui doit être appliqué à la barre d’action lorsque la transition commence. Cette méthode doit être remplacée par des sous-classes si un effet de barre d’action personnalisé est requis. Par défaut, cette méthode renvoie un effet de barre d’action élémentaire.
IEffect — Instance de IEffect qui fait office d’effet de barre d’action. L’effet est appliqué par l’implémentation de la méthode play() par défaut.
|
createConsolidatedEffect | () | méthode |
protected function createConsolidatedEffect():IEffect| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Appelée par l’implémentation de la méthode prepareForPlay() par défaut, cette méthode est chargée de créer l’effet Spark qui est appliqué pour effectuer la transition du navigateur entier (y compris du contenu de la barre de contrôle) lorsque cela est nécessaire. Cette méthode doit être remplacée par des sous-classes. Par défaut, cette méthode renvoie la valeur null.
IEffect — Instance de IEffect qui fait office de transition de vue. L’effet est appliqué par l’implémentation de la méthode play() par défaut.
|
createTabBarEffect | () | méthode |
protected function createTabBarEffect():IEffect| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Appelée par l’implémentation de la méthode prepareForPlay()par défaut, cette méthode est chargée de créer l’effet Spark qui doit être appliqué à la barre d’onglets lorsque la transition commence. Cette méthode doit être remplacée par des sous-classes. Par défaut, cette méthode renvoie la valeur null.
IEffect — Instance de IEffect qui fait office de transition de barre d’onglets. L’effet est appliqué par l’implémentation de la méthode play() par défaut.
|
createViewEffect | () | méthode |
protected function createViewEffect():IEffect| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Appelée par l’implémentation de la méthode prepareForPlay()par défaut, cette méthode est chargée de créer l’effet Spark qui est appliqué à la vue actuelle et à la vue suivante lorsque la transition commence. Cette méthode doit être remplacée par des sous-classes. Par défaut, cette méthode renvoie la valeur null.
IEffect — Instance de IEffect qui fait office de transition de vue. L’effet est appliqué par l’implémentation de la méthode play() par défaut.
|
getSnapshot | () | méthode |
protected function getSnapshot(target:UIComponent, padding:int = 4, globalPosition:Point = null):BitmapImage| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Permet d’effectuer le rendu d’instantanés des éléments d’écran en phase de préparation pour la transition. L’image bitmap est renvoyée sous la forme d’un objet BitmapImage.
La classe BitmapImage se situe dans l’espace de coordonnées parents de la cible. Elle recouvre précisément la cible si elle a le même parent. Lors du déplacement vers un autre parent, assurez-vous de régler la transformation de la classe BitmapImage correctement pour tenir compte de la modification dans des espaces de coordonnées. La valeur mise à jour du paramètre globalPosition peut être ici utilisée.
Paramètres
target:UIComponent — Objet d’affichage à capturer.
| |
padding:int (default = 4) | |
globalPosition:Point (default = null)globalPosition sera mis à jour avec l’origine de la classe BitmapImage dans les coordonnées globales. Lors du déplacement vers un autre espace de coordonnées, cette valeur peut être utilisée pour régler la position de l’instantané, de sorte que la position globale à l’écran ne change pas.
|
BitmapImage — Objet BitmapImage représentant la cible.
|
play | () | méthode |
public function play():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Appelée par le composant ViewNavigator lorsque la transition doit commencer l’animation. A ce stade, la transition doit distribuer un événement start.
prepareForPlay | () | méthode |
public function prepareForPlay():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Appelée par le composant ViewNavigator pendant la phase de préparation d’une transition. Cette méthode permet à la transition de créer et configurer l’instance IEffect sous-jacente ou d’ajouter des éléments transitoires à la liste d’affichage. Les éléments transitoires sont par exemple des espaces réservés bitmap, des conteneurs temporaires nécessaires au cours de la transition et d’autres éléments. Le cas échéant, une validation finale survient avant l’invocation de la méthode play().
S’il est déterminé qu’une transition standard peut être lancée (c’est-à-dire qu’elle assure la transition des barres de contrôle séparément des vues), l’implémentation par défaut de cette méthode crée un effet Parallel unique qui regroupe les séquences d’effet individuelles pour la transition de la vue, la transition de la barre d’action et la transition de la barre d’onglets. Cette méthode utilise les méthodes createActionBarEffect(), createTabBarEffect() et createViewEffect().
Si transitionControlsWithContent a la valeur true, ou s’il est déterminé que la transition des barres de contrôle ne peut pas être effectuée indépendamment, un effet unique est créé pour effectuer la transition du navigateur dans son intégralité. Dans ce cas, seule la méthode createConsolidatedEffect() est invoquée.
transitionComplete | () | méthode |
protected function transitionComplete():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Appelée par la transition pour indiquer que la transition est terminée. Cette méthode distribue l’événement end.
transitionEnd | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.TRANSITION_START| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Distribué lorsque la transaction se termine.
La constanteFlexEvent.TRANSITION_START définit la valeur de la propriété type de l’objet d’événement d’un événement transitionStart.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
transitionStart | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.TRANSITION_START| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | AIR 2.5 |
Distribuée lorsque la transition commence.
La constanteFlexEvent.TRANSITION_START définit la valeur de la propriété type de l’objet d’événement d’un événement transitionStart.
Cet événement est distribué uniquement lorsqu’il existe un ou plusieurs écouteurs concernés associés à l’objet de distribution.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
Tue Jun 12 2018, 09:30 AM Z