| Package | mx.effects |
| Classe | public class Zoom |
| Héritage | Zoom  TweenEffect Effect EventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
 | A partir de Flex 4.0, Adobe vous recommande d’utiliser la classe spark.effects.Scale comme alternative à cette classe. |
L’effet Zoom pour effectuer un zoom avant ou un zoom arrière de l’objet sur un point central.
Lorsque vous appliquez un effet Zoom sur le texte rendu à l’aide d’une police système, Flex met le texte entre les tailles intégrales des points. Etant donné qu’il n’est pas nécessaire d’utiliser des polices intégrées lorsque vous appliquez un effet Zoom au texte, le Zoom est plus lisse lorsque vous l’appliquez à des polices intégrées.
Remarque : l’effet Zoom ne fonctionne pas lorsque la propriété Container.autoLayout est définie sur false.
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:Zoom> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:Zoom
id="ID"
captureRollEvents="false|true"
originX="Calculated"
originY="Calculated"
zoomWidthFrom="0.01"
zoomWidthTo="1.0"
zoomHeightFrom="0.01"
zoomHeightTo="1.0"
/>
Eléments de l’API associés
| Propriété | Défini par | ||
|---|---|---|---|
| captureRollEvents : Boolean
La valeur true empêche Flex d’envoyer des événements rollOut et rollOver si la souris n’a pas été déplacée. | Zoom | ||
 | className : String [lecture seule]
Le nom de la classe d’effet, tel que « Fade ». | Effect | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| customFilter : mx.effects:EffectTargetFilter
Spécifie un objet filtre personnalisé, de type EffectTargetFilter, utilisé par l’effet pour déterminer les cibles sur lequel lire l’effet. | Effect | |
| duration : Number
Durée de l’effet en millisecondes. | Effect | |
| easingFunction : Function = null
Fonction d’accélération pour l’animation. | TweenEffect | |
| effectTargetHost : mx.effects:IEffectTargetHost
Propriété qui permet d’accéder au contrôle à base de liste de la cible d’un effet data. | Effect | |
| filter : String
Spécifie un algorithme de filtrage des cibles d’un effet. | Effect | |
| hideFocusRing : Boolean
Détermine si l’effet doit masquer l’anneau de focus lors du démarrage. | Effect | |
| instanceClass : Class
Objet de type Class qui spécifie la classe de l’instance d’effet de cette classe d’effets. | Effect | |
| isPlaying : Boolean [lecture seule]
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. | Effect | |
| originX : Number
Nombre représentant la position x de l’origine du zoom lorsque la cible de l’effet se trouve dans un conteneur qui prend en charge le positionnement absolu, tel que le conteneur Canvas. | Zoom | ||
| originY : Number
Nombre représentant la position y de l’origine du zoom lorsque la cible de l’effet se trouve dans un conteneur qui prend en charge le positionnement absolu, tel que le conteneur Canvas. | Zoom | ||
| perElementOffset : Number
Autre délai, en millisecondes, pour les cibles d’effet suivant la première cible de l’effet. | Effect | |
| playheadTime : Number
Temps de position actuelle de l’effet. | Effect | |
| relevantProperties : Array
Tableau de noms de propriété à utiliser pour effectuer le filtrage. | Effect | |
| relevantStyles : Array
Tableau des noms de style à utiliser pour effectuer le filtrage. | Effect | |
| repeatCount : int = 1
Nombre de fois que l’effet doit être répété. | Effect | |
| repeatDelay : int = 0
Intervalle (en millisecondes), qui s’écoule avant de répéter l’effet. | Effect | |
| startDelay : int = 0
Intervalle (en millisecondes), qui s’écoule avant de commencer l’effet. | Effect | |
| suspendBackgroundProcessing : Boolean = false
Si la valeur est true, elle bloque tout le traitement en arrière-plan pendant l’exécution de l’effet. | Effect | |
| target : Object
Objet auquel s’applique cet effet. | Effect | |
| targets : Array
Tableau d’objets représentant des cibles de l’effet. | Effect | |
| triggerEvent : Event
Objet Evénement transmis à cet Effet par le gestionnaire EffectManager lorsqu’un effet est déclenché, ou nul si l’effet n’est pas exécuté par le gestionnaire EffectManager. | Effect | |
| zoomHeightFrom : Number
Nombre qui représente l’échelle à utiliser pour démarrer le zoom de la hauteur, exprimé en pourcentage compris entre 0.01 et 1.0. | Zoom | ||
| zoomHeightTo : Number
Nombre qui représente l’échelle à utiliser pour terminer le zoom de la hauteur, exprimé en pourcentage compris entre 0.01 et 1.0. | Zoom | ||
| zoomWidthFrom : Number
Nombre qui représente l’échelle à utiliser pour démarrer le zoom de la largeur, exprimé en pourcentage compris entre 0.01 et 1.0. | Zoom | ||
| zoomWidthTo : Number
Nombre qui représente l’échelle à utiliser pour terminer le zoom de la largeur, exprimé en pourcentage compris entre 0.01 et 1.0. | Zoom | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | Zoom | ||
| 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 | |
|
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. | Effect | |
|
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é.
| Effect | |
|
Capture les valeurs actuelles des propriétés correspondantes sur les cibles de l’effet. | Effect | |
|
Crée une seule instance d’effet et l’initialise. | Effect | |
|
Prend un tableau d’objets cible et invoque la méthode createInstance() sur chaque cible. | Effect | |
|
Supprime les écouteurs d’événement d’une instance et les retire de la liste d’instances. | Effect | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Interrompt un effet en cours de lecture et passe immédiatement à la fin de l’effet. | Effect | |
|
Renvoie un tableau de chaînes, où chaque chaîne correspond au nom d’une propriété modifiée par cet effet. | Effect | |
|
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 | |
|
Interrompt momentanément l’effet jusqu’à un appel de la méthode resume(). | Effect | |
|
Commence la lecture de l’effet. | Effect | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Reprend l’effet après une interruption demandée par un appel de la méthode pause(). | Effect | |
|
Exécute l’effet en sens inverse, si l’effet est en cours de lecture, à partir de sa position actuelle. | Effect | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Arrête l’effet, en laissant les cibles de l’effet dans leur état actuel. | Effect | |
|
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 | |
captureRollEvents | propriété |
public var captureRollEvents:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
La valeur true empêche Flex d’envoyer des événements rollOut et roolOver si la souris n’a pas été déplacée. Définissez cette propriété sur true lorsque vous utilisez l’effet Zoom pour faire basculer la cible de l’effet entre une grande et une petite taille.
Par exemple, vous utilisez la méthode rollOverEffect pour déclencher l’effet Zoom afin de diminuer la taille de la cible. Au fur et à mesure que la cible réduit, le pointeur de la souris n’est plus au dessus de la cible, déclenchant un événement rollOut et l’effet rollOutEffect correspondant. En définissant la propriété captureRollEvent sur true, vous empêcher Flex d’envoyer des événements rollOut, sauf s’ils se produisent lorsque vous avez déplacé la souris.
La valeur par défaut est false.
originX | propriété |
public var originX:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre représentant la position x de l’origine du zoom lorsque la cible de l’effet se trouve dans un conteneur qui prend en charge le positionnement absolu, tel que le conteneur Canvas. L’origine du zoom est la position sur la cible autour de laquelle l’effet Zoom est centré.
La valeur doit être comprise entre 0 et la largeur du composant cible.
La valeur par défaut esttarget.width / 2, qui correspond au centre de la cible.
originY | propriété |
public var originY:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre représentant la position y de l’origine du zoom lorsque la cible de l’effet se trouve dans un conteneur qui prend en charge le positionnement absolu, tel que le conteneur Canvas. L’origine du zoom est la position sur la cible autour de laquelle l’effet Zoom est centré.
La valeur doit être comprise entre 0 et la hauteur du composant cible.
La valeur par défaut esttarget.hauteur / 2, qui correspond au centre de la cible.
zoomHeightFrom | propriété |
public var zoomHeightFrom:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre qui représente l’échelle à utiliser pour démarrer le zoom de la hauteur, exprimé en pourcentage compris entre 0.01 et 1.0. La valeur par défaut, 0.01, est très faible.
zoomHeightTo | propriété |
public var zoomHeightTo:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre qui représente l’échelle à utiliser pour terminer le zoom de la hauteur, exprimé en pourcentage compris entre 0.01 et 1.0. La valeur par défaut est 1.0, ce qui correspond à la taille normale de l’objet.
zoomWidthFrom | propriété |
public var zoomWidthFrom:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre qui représente l’échelle à utiliser pour démarrer le zoom de la largeur, exprimé en pourcentage compris entre 0.01 et 1.0. La valeur par défaut, 0.01, est très faible.
zoomWidthTo | propriété |
public var zoomWidthTo:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Nombre représentant l’échelle à laquelle terminer le dimensionnement de la largeur. Exemple, un pour cent entre 0,01 et 1,0. La valeur par défaut est 1,0, ce qui correspond à la taille normale de l’objet.
Zoom | () | Constructeur |
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Zoom effect. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Script>
<![CDATA[
import flash.events.MouseEvent;
public function doZoom(event:MouseEvent):void {
if (zoomAll.isPlaying) {
zoomAll.reverse();
}
else {
// If this is a ROLL_OUT event, play the effect backwards.
// If this is a ROLL_OVER event, play the effect forwards.
zoomAll.play([event.target], event.type == MouseEvent.ROLL_OUT ? true : false);
}
}
]]>
</fx:Script>
<fx:Declarations>
<mx:Zoom id="zoomAll" zoomWidthTo="1" zoomHeightTo="1" zoomWidthFrom=".5" zoomHeightFrom=".5" />
</fx:Declarations>
<s:Panel title="Zoom Effect Example" width="95%" height="95%" >
<s:VGroup left="20" right="20" top="20" bottom="20">
<s:Label width="100%" color="blue"
text="Move the mouse over the image to enlarge it. Move the mouse off of the image to shrink it."/>
<mx:Image id="img"
source="@Embed(source='assets/Nokia_6630.png')"
scaleX=".5" scaleY=".5"
rollOver="doZoom(event)"
rollOut="doZoom(event)"/>
</s:VGroup>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z