Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
spark.transitions 

ViewTransitionBase  - AS3 Flex

Packagespark.transitions
Classepublic class ViewTransitionBase
HéritageViewTransitionBase Inheritance EventDispatcher Inheritance 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

La classe ViewTransitionBase est la classe de base pour toutes les transitions de vue. Elle n’est pas destinée à être utilisée seule comme transition. En plus de fournir des méthodes de commodité et d’assistance communes utilisées par les transitions de vues, cette classe fournit une séquence de transition de barre d’action par défaut.

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 start est 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.



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : 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éthodes publiques
 MéthodeDéfini par
  
Constructeur.
ViewTransitionBase
 Inherited
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
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
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
  
    play():void
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
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éthodes protégées
 MéthodeDéfini par
  
Déterminer si Flex peut effectuer une transition sur barre d’action ou barre d’onglets contenu indépendamment des vues.
ViewTransitionBase
  
    cleanUp():void
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
  
    getSnapshot(target:UIComponent, padding:int = 4, globalPosition:Point = null):BitmapImage
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énements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
 Inherited[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
Détails de la propriété
    

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):void

Elé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):void

Elé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
Détails du constructeur
    

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.

Détails de la méthode

    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 overlayControls propriété les modifications effectuées entre les vues.
  • Si la taille ou la visibilité de la barre d’action change entre les vues.

Valeur renvoyée
Booleanfalse 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.

Valeur renvoyée
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.

Valeur renvoyée
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.

Valeur renvoyée
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.

Valeur renvoyée
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) — Marge autour de l’objet à inclure dans l’objet BitmapImage.
 
globalPosition:Point (default = null) — S’il n’est pas nul, 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.

Valeur renvoyée
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.

Détails de l’événement
    

transitionEnd

Evénement
Type d’objet d’événement: mx.events.FlexEvent
proprié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 constante FlexEvent.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
bubblesfalse
cancelablefalse
currentTargetObjet 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.
targetObjet 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  
Type d’objet d’événement: mx.events.FlexEvent
proprié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 constante FlexEvent.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
bubblesfalse
cancelablefalse
currentTargetObjet 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.
targetObjet 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.




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.