Effect  - AS3 Flex

Cet indicateur contrôle si l’effet, lorsqu’il est exécuté dans une transition, applique automatiquement les valeurs de propriété conformément à l’état d’arrivée, au lieu de conserver ces valeurs comme l’a défini l’effet lui-même.

La valeur par défaut est true.

Le nom de la classe d’effet, tel que "Fade".

Il s’agit d’un nom de classe court, ou incomplet qui ne contient pas le nom du package. Pour obtenir le nom complet, utilisez la méthode getQualifiedClassName() du package flash.utils.

Spécifie un objet filtre personnalisé, de type EffectTargetFilter, utilisé par l’effet pour déterminer les cibles sur lequel lire l’effet.

Le filtrage des cibles est effectué uniquement si vous appelez la méthode captureStartValues() avant d’exécuter l’effet. Flex appelle automatiquement la méthode captureStartValues() lorsque l’effet fait partir d’une transition.

Utilisez la propriété filter pour un filtrage simple. Si la propriété customFilter n’est pas nulle, la propriété filter est ignorée.

Durée de l’effet en millisecondes.

Dans un effet Parallel ou Sequence, la propriété duration définit la durée de chaque effet. Par exemple, si la propriété duration d’un effet Sequence est définie sur 3 000, chaque effet dans la séquence prend 3 000 ms pour s’exécuter.

Pour un effet répété, la propriété duration spécifie la durée d’une seule instance de l’effet. Par conséquent, si la propriété duration d’un effet est définie sur 2 000 et la propriété repeatCount est définie sur 3, l’effet prend un total de 6 000 ms (6 secondes) pour s’exécuter.

Propriété permettant d’accéder au contrôle à base de liste d’un effet data. Cette propriété permet à une instance d’une classe d’effet de communiquer avec le contrôle à base de liste sur lequel l’effet est exécuté.

Drapeau contenant la valeur true si les valeurs d’arrivée ont déjà été déterminées, ou false si elles doivent être acquises à partir des propriétés actuelles des cibles de l’effet lorsque les effets s’exécutent. Cette propriété est requise par les effets de données effets car la séquence de configuration des effets de données, tels que les effets DefaultListEffect et DefaultTileListEffect sont plus complexes que pour les effets ordinaires.

La valeur par défaut est false.

Spécifie un algorithme de filtrage des cibles d’un effet. Une valeur null spécifie l’absence de filtrage.

Le filtrage des cibles est effectué uniquement si vous appelez la méthode captureStartValues() avant d’exécuter l’effet. Flex appelle automatiquement la méthode captureStartValues() lorsque l’effet fait partir d’une transition, ou d’un effet data d’un contrôle à base de liste.

Utilisez cette propriété pour effectuer un filtrage simple. Utilisez la propriété customFilter pour un filtrage plus complexe. Si la propriété customFilter a une valeur non nulle, elle est ignorée.

Vous pouvez utiliser les valeurs suivantes pour la propriété filter.

• Une valeur "add" exécute l’effet sur les cibles ajoutées en tant qu’enfant dans un conteneur.
• Une valeur "addItem" exécute l’effet sur la fonctionnalité de rendu d’élément pour tous les éléments de liste ajourés à un contrôle List ou TileList.
• Une valeur "hide" exécute l’effet sur des cibles dont la propriété visible a été modifiée de true à false.
• Une valeur "move" exécute l’effet sur une cible qui a modifié ses propriétés x ou y.
• Une valeur "remove" exécute l’effet sur des cibles supprimées en tant qu’enfant d’un conteneur.
• Une valeur "removeItem" exécute l’effet sur la fonctionnalité de rendu d’élément des éléments de liste supprimés d’un contrôle List ou TileList.
• Une valeur "replaceItem" exécute l’effet sur la fonctionnalité de rendu d’élément des éléments de liste remplacés dans un contrôle List ou TileList par un nouvel élément.
• Une valeur "replacementItem" exécute l’effet sur la fonctionnalité de rendu d’élément des éléments de liste ajoutés à un contrôle List ou TileList qui remplace un élément existant.
• Une valeur "resize" exécute l’effet sur des cibles qui ont modifié leur propriétés width ou height.
• Une valeur "show" exécute l’effet sur les cibles dont la propriété visible a été modifiée de false à true.
• Une valeur "" indique l’absence de filtrage.

Détermine si l’effet doit masquer l’anneau de focus lors du démarrage. La cible de l’effet est responsable du masquage de l’anneau de focus. Les sous-classes de la classe UIComponent masquent automatiquement l’anneau de focus. Si l’effet cible n’est pas une sous-classe de la classe UIComponent, ajoutez-y des fonctionnalités pour masquer l’anneau de focus.

Définissez cette propriété sur true pour masquer l’anneau de focus pendant l’effet.

Pour les sous-classes de Effect, la valeur par défaut est false. Pour les sous-classes MaskEffect, la valeur par défaut est true.

Objet de type Class qui spécifie la classe de l’instance d’effet de cette classe d’effets.

Toutes les sous-classes de la classe Effect doivent définir cette propriété dans le constructeur.

Indicateur de lecture seule défini sur true si les instances de l’effet sont en cours de lecture et sur false si aucune instance n’est définie.

Autre délai, en millisecondes, pour les cibles d’effet suivant la première cible de l’effet. Cette valeur est ajoutée à la valeur de la propriété startDelay.

Position temporelle actuelle de l’effet. Cette propriété a une valeur comprise entre 0 et la durée totale, qui inclut les propriétés startDelay, repeatCount et repeatDelay de l’effet.

Tableau de noms de propriété à utiliser pour effectuer le filtrage. Cette propriété est utilisée en interne et ne doit pas être définie par les utilisateurs d’effets.

La valeur par défaut est égale à la valeur du tableau renvoyée par la méthode getAffectedProperties().

Tableau des noms de style à utiliser pour effectuer le filtrage. Cette propriété est utilisée en interne et ne doit pas être définie par les utilisateurs d’effets.

La valeur par défaut est égale à la valeur du tableau renvoyée par la méthode getAffectedProperties().

Nombre de fois que l’effet doit être répété. Les valeurs possibles sont tout entier supérieur ou égal à 0. La valeur 1 signifie que l’effet doit être lu une fois. La valeur 0 indique que l’effet est exécuté en continu jusqu’à ce qu’il soit explicitement arrêté par un appel à, la méthode end().

La valeur par défaut est 1.

Intervalle (en millisecondes), qui s’écoule avant de répéter l’effet. Les valeurs possibles sont tout entier supérieur ou égal à 0.

La valeur par défaut est 0.

Intervalle (en millisecondes), qui s’écoule avant de commencer l’effet. Les valeurs possibles sont tout entier supérieur ou égal à  0. Si l’effet est répété à l’aide de la propriété repeatCount, startDelay est appliquée uniquement la première fois que l’effet est exécuté.

La valeur par défaut est 0.

Si la valeur est true, elle bloque l’ensemble du traitement en arrière-plan pendant que l’effet est exécuté. Le traitement en arrière-plan comprend la mesure, la mise en forme et le traitement des réponses arrivées en provenance du serveur. La valeur par défaut est false.

Il est recommandé de définir cette propriété sur true dans la plupart des cas, car elle améliore les performances de l’application. Toutefois, la propriété doit être définie sur false si l’une des opérations suivantes est effective :

• L’entrée utilisateur peut arriver lorsque l’effet est en cours de lecture et l’application doit répondre à l’entrée utilisateur avant que l’effet s’arrête.
• Une réponse peut arriver en provenance du serveur pendant que l’effet est exécuté et l’application doit traiter la réponse lorsque l’effet est toujours exécuté.

La valeur par défaut est false.

Objet auquel s’applique cet effet. Lorsque l’effet est déclenché par un déclencheur d’effets, la propriété target est automatiquement définie sur l’objet qui déclenche l’effet.

Tableau d’objets représentant des cibles de l’effet. Lorsque l’effet est en cours de lecture, il effectue l’effet sur chaque cible en parallèle. La définition de la propriété target remplace tous les objets dans ce tableau. Lorsque la propriété targets est définie, la propriété target renvoie le premier élément de ce tableau.

Objet Evénement transmis à cet Effet par le gestionnaire EffectManager lorsqu’un effet est déclenché, ou null si l’effet n’est pas exécuté par le gestionnaire EffectManager.

Constructeur.

Le démarrage d’un effet est généralement un processus à trois étapes :

• Créez une instance de l’objet d’effet à l’aide de l’opérateur new.
• Définissez les propriétés sur l’objet d’effet, telles que duration.
• Appelez la méthode play() ou attribuez l’effet à un déclencheur.

Utilisée en interne par l’infrastructure Effet. Si la méthode captureStartValues() a été appelée, lorsque Flex appelle la méthode play(), il utilise cette fonction pour renvoyer les cibles à leur état de départ. Le comportement par défaut est de prendre la valeur capturée à l’aide de la méthode getValueFromTarget() et de la définir directement sur la propriété de la cible. Par exemple :

      
      target[property] = value;

Remplacez uniquement cette méthode si vous devez appliquer les valeurs capturées d’une autre façon. Notez que les propriétés de style de la cible sont définies à l’aide d’une autre mécanisme. Utilisez la propriété relevantStyles pour spécifier les propriétés de style à capturer et à appliquer.

Paramètres

Capture les valeurs actuelles des propriétés correspondantes sur les cibles de l’effet et les enregistre en tant que valeurs d’arrivée.

Flex appelle automatiquement la méthode captureEndValues() lorsque l’effet fait partir de l’effet de modification de données.

Capture les valeurs actuelles des propriétés correspondantes d’un autre ensemble de cibles.

Flex utilise cette fonction lorsqu’un effet de modifications de données est exécuté.

Paramètres

Capture les valeurs actuelles des propriétés correspondantes sur les cibles de l’effet. Flex appelle automatiquement la méthode captureStartValues() lorsque l’effet fait partir d’une transition.

Utilisez cette fonction lorsque vous souhaitez que l’effet calcule les valeurs de départ et d’arrivée de l’effet. La meilleure façon d’exploiter cette fonction est de l’utiliser selon les étapes suivantes :

1. Appelez la méthode captureStartValues(). L’effet enregistre les valeurs de départ de l’effet.
2. Modifiez les changements apportés aux cibles d’effets, tels que l’ajout/la suppression des enfants, l’altération des propriétés, le changement de l’emplacement ou le changement des dimensions.
3. Appelez la méthode play(). L’effet capture les valeurs d’arrivée. Cette fonction remplit la propriété EffectInstance.propertyChanges pour chaque instance d’effet créée par cet effet. Les développeurs d’effets peuvent utiliser la propriété propertyChanges pour récupérer les valeurs de départ et d’arrivée de leur effet.

Crée une seule instance d’effet et l’initialise. Utilisez cette méthode plutôt que la méthodeplay() pour manipuler les propriétés instance d’effet avant que l’instance d’effet soit exécuté.

L’instance d’effet est créé avec le type spécifié dans la propriété instanceClass. Elle est ensuite initialisée à l’aide de la méthode initInstance(). Si l’instance a été créée par Effectmanager (lorsque l’effet est déclenché par un déclencheur d’effet), l’effet est davantage initialisé par un appel de la méthode EffectInstance.initEffect().

Le fait d’appeler la méthode createInstance() n’exécute pas l’effet. Appelez la méthode startEffect() de l’instance d’effet renvoyée.

Cette fonction est appelée automatiquement par la méthode Effect.play().

Paramètres

Prend un tableau d’objets cible et invoque la méthode createInstance() sur chaque cible.

Paramètres

Supprime les écouteurs d’événement d’une instance et les retire de la liste d’instances.

Paramètres

Appelée à la fin de la lecture d’une instance d’effet. Si vous remplacez cette méthode, prenez soin d’appeler la méthode super.

Paramètres

Cette méthode est appelée lorsque l’instance d’effet commence. Si vous remplacez cette méthode, prenez soin d’appeler la méthode super.

Paramètres

Appelée lorsqu’une instance d’effet a été interrompue par un appel de la méthode stop(). Si vous remplacez cette méthode, prenez soin d’appeler la méthode super.

Paramètres

Interrompt un effet en cours de lecture et passe immédiatement à la fin de l’effet. L’appel de cette méthode invoque la méthode EffectInstance.end().

L’instance d’effet distribue un événement effectEnd lorsque vous appelez cette méthode dans le cadre de l’arrêt de l’effet.

Si vous transmettez une instance d’effet en tant qu’argument, seule cette instance est interrompue. Si aucun argument est transmis, toutes les instances d’effet actuellement générées à partir de l’effet sont interrompues.

Paramètres

Détermine la logique de filtrage d’une instance d’effet. La classe CompositeEffect remplace cette méthode.

Paramètres

Renvoie un tableau de chaînes, où chaque chaîne correspond au nom d’une propriété modifiée par cet effet. Par exemple, l’effet Move renvoie un tableau contenant "x" et "y ".

Chaque sous-classe d’Effet doit implémenter cette méthode. La méthode est utilisée par la classe EffectManager pour éviter que deux effets tentent d’animer la même propriété du même objet au même moment.

Appelée par une méthode captureStartValues() pour obtenir la valeur d’une propriété à partir de la cible. Cette fonction doit être appelée uniquement en interne par la structure des effets. Le comportement par défaut est de renvoyer simplement la propriété target[property]. Les développeurs d’effets peuvent remplacer cette fonction si vous avez besoin d’un autre comportement.

Paramètres

Copie les propriétés de l’effet vers l’instance d’effet.

Flex appelle cette méthode à partir de la méthode Effect.createInstance(). Il n’est pas nécessaire de l’appeler manuellement.

Lorsque vous créez un effet personnalisé, remplacez cette méthode de manière à copier les propriétés de la classe Effect vers la classe d’instance d’effet. Lors du emplacement, appelez la méthode super.initInstance().

Paramètres

Interrompt momentanément l’effet jusqu’à un appel de la méthode resume().

Commence la lecture de l’effet. Appelez la méthode end avant d’appeler la méthode play() pour vous assurer que toute instance précédente de l’effet est terminée avant d’en commencer une nouvelle.

Toutes les sous-classes doivent implémenter cette méthode.

Paramètres

Reprend l’effet après une interruption demandée par un appel de la méthode pause().

Exécute l’effet en sens inverse, si l’effet est en cours de lecture, à partir de sa position actuelle.

Arrête l’effet, en laissant les cibles de l’effet dans leur état actuel. Contrairement à un appel de la méthode pause(), vous ne pouvez pas appeler la méthode resume() après avoir appelé la méthode stop(). Vous pouvez cependant appeler la méthode play() pour redémarrer l’effet.

L’instance d’effet distribue un événement effectEnd lorsque vous appelez cette méthode dans le cadre de l’arrêt de l’effet.

Pour les effets de masque, le masque n’est pas supprimé automatiquement lorsque l’effet est arrêté. Exécuter davantage des effets de masque sur la même cible sans supprimer le masque peut produire des résultats inattendus.

Distribué lorsque la lecture de l’une des instances de l’effet s’arrête, soit lorsque la lecture de l’instance s’arrête, soit lorsque l’effet est interrompu par un appel de la méthode end().

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

Diffusé lorsque l’exécution de l’effet commence.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

Distribué lorsque l’effet a été interrompu, ce qui se produit uniquement lorsque l’effet est interrompu par un appel de la méthode stop(). L’événement EFFECT_END est également distribué pour indiquer la fin de l’effet. Cet événement supplémentaire est envoyé en premier, comme pour signaler aux écouteurs que l’effet n’a pas atteint son état d’arrivée.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :