Paket | spark.effects |
Klasse | public class Animate |
Vererbung | Animate Effect EventDispatcher Object |
Unterklassen | AnimateColor, AnimateFilter, AnimateTransform, AnimateTransitionShader, Fade, Resize |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
motionPaths
-Eigenschaft einstellen.
MXML-SyntaxMXML-Syntax ausblendenThe <s:Animate>
tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<s:Animate Properties id="ID" disableLayout="false" easer="{spark.effects.easing.Sine(.5)}" interpolator="NumberInterpolator" motionPaths="no default" repeatBehavior="loop" />
Standard-MXML-EigenschaftmotionPaths
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
className : String [schreibgeschützt]
Name der Effektklasse wie „Fade“. | Effect | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
customFilter : mx.effects:EffectTargetFilter
Gibt ein benutzerdefiniertes Filterobjekt des Typs EffectTargetFilter an, das zur Ermittlung der Ziele dient, bei denen der Effekt wiedergegeben wird. | Effect | ||
disableLayout : Boolean
Wenn der Wert „true“ ist, wird durch den Effekt das Layout auf den übergeordneten Containern der Ziele deaktiviert, indem die autoLayout-Eigenschaft der Container auf „false“ gesetzt wird, und alle Layoutbeschränkungen auf Zielobjekten werden deaktivert. | Animate | ||
duration : Number
Dauer des Effekts in Millisekunden. | Effect | ||
easer : IEaser
Das Beschleunigungsverhalten für diesen Effekt. | Animate | ||
effectTargetHost : mx.effects:IEffectTargetHost
Eine Eigenschaft, die Ihnen den Zugriff auf listenbasierte Zielsteuerelemente eines Dateneffekts ermöglicht. | Effect | ||
filter : String
Gibt einen Algorithmus zum Filtern der Ziele für einen Effekt an. | Effect | ||
hideFocusRing : Boolean
Bestimmt, ob der Effekt den Fokusring beim Start ausblenden soll. | Effect | ||
instanceClass : Class
Ein Objekt der type-Klasse, das die Effektinstanzklasse für diese Effektklasse angibt. | Effect | ||
interpolator : IInterpolator
Der Interpolator, der von diesem Effekt verwendet wird, um Werte zwischen den Anfangs- und Endwerten einer Eigenschaft zu berechnen. | Animate | ||
isPlaying : Boolean [schreibgeschützt]
Ein Flag für den Schreibschutz, das auf „true“ gesetzt ist, wenn Instanzen des Effekts aktuell wiedergegeben werden, und andernfalls auf „false“. | Effect | ||
motionPaths : Vector.<MotionPath>
Ein Vektor von MotionPath-Objekten, die alle den Namen einer zu animierenden Eigenschaft und die während der Animation von der Eigenschaft verwendeten Werte enthalten. | Animate | ||
perElementOffset : Number
Zusätzliche Verzögerung (in Millisekunden) für Effektziele nach dem ersten Ziel des Effekts. | Effect | ||
playheadTime : Number
Aktuelle Zeitposition des Effekts. | Effect | ||
relevantProperties : Array
Ein Array von Eigenschaftsnamen zur Verwendung beim Filtern. | Effect | ||
relevantStyles : Array
Ein Array von Stilnamen zur Verwendung beim Filtern. | Effect | ||
repeatBehavior : String
Das Verhalten eines sich wiederholenden Effekts, also eines Effekts mit repeatCount gleich 0 oder > 1. | Animate | ||
repeatCount : int = 1
Ein Wert, der angibt, wie oft der Effekt wiederholt werden soll. | Effect | ||
repeatDelay : int = 0
Wartezeit in Millisekunden vor der Wiederholung des Effekts. | Effect | ||
startDelay : int = 0
Wartezeit in Millisekunden vor dem Starten des Effekts. | Effect | ||
target : Object
Das Objekt, auf das dieser Effekt angewendet wird. | Effect | ||
targets : Array
Ein Array von Objekten, die als Ziele des Effekts verwendet werden können. | Effect | ||
triggerEvent : Event
Der EffectManager übergibt diesem Effekt das Ereignisobjekt, wenn ein Effekt ausgelöst wird, oder null, wenn der Effekt nicht vom EffectManager wiedergegeben wird. | Effect |
Methode | Definiert von | ||
---|---|---|---|
Konstruktor. | Animate | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | ||
Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts und speichert sie als Endwerte. | Effect | ||
Erfasst die aktuellen Werte der relevanten Eigenschaften eines zusätzlichen Zielsatzes. Flex verwendet diese Funktion, wenn ein Datenänderungseffekt ausgeführt wird.
| Effect | ||
Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts. | Effect | ||
Erstellt eine einzelne Effektinstanz und initialisiert sie. | Effect | ||
Verwendet ein Array von Zielobjekten und ruft die createInstance()-Methode auf jedem Ziel auf. | Effect | ||
Entfernt Ereignis-Listener von einer Instanz und entfernt sie aus der Liste der Instanzen. | Effect | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Unterbricht einen aktuell wiedergegebenen Effekt und springt sofort zum Ende des Effekts. | Effect | ||
Gibt ein Array von Strings zurück, wobei jeder String dem Namen einer Eigenschaft entspricht, die von diesem Effekt geändert wird. | Effect | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Hält den Effekt an, bis die resume()-Methode aufgerufen wird. | Effect | ||
Startet die Wiedergabe des Effekts. | Effect | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde. | Effect | ||
Gibt den aktuell wiedergegebenen Effekt rückwärts wieder und beginnt dabei an der aktuellen Position des Effekts. | Effect | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Hält den Effekt an und behält den aktuellen Status der Effektziele bei. | Effect | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
Wird ausgelöst, wenn die Wiedergabe einer der Effektinstanzen beendet wurde, da die Instanz das Ende erreicht hatte oder da der Effekt durch den Aufruf der end()-Methode unterbrochen wurde. | Effect | |||
Wird ausgelöst, wenn der Effekt eine neue Wiederholung beginnt, und zwar für jeden Effekt, der mehr als einmal wiederholt wird. | Animate | |||
Wird ausgelöst, wenn die Wiedergabe eines Effekts gestartet wird. | Effect | |||
Wird ausgelöst, wenn der Effekt angehalten wurde. Dies geschieht nur, wenn der Effekt durch Aufrufen der stop()-Methode unterbrochen wird. | Effect | |||
Wird jedes Mal ausgelöst, wenn der Effekt das Ziel aktualisiert. | Animate |
disableLayout | Eigenschaft |
disableLayout:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wenn der Wert true
ist, wird durch den Effekt das Layout auf den übergeordneten Containern der Ziele deaktiviert, indem die autoLayout
-Eigenschaft der Container auf „false“ gesetzt wird, und alle Layoutbeschränkungen auf Zielobjekten werden deaktivert. Diese Eigenschaften werden wiederhergestellt, wenn der Effekt beendet ist.
Der Standardwert ist false.
Implementierung
public function get disableLayout():Boolean
public function set disableLayout(value:Boolean):void
easer | Eigenschaft |
easer:IEaser
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Das Beschleunigungsverhalten für diesen Effekt. Dieses IEaser-Objekt wird verwendet, um den abgelaufenen Teil der Animation in einen beschleunigten Teil zu konvertieren, der anschließend verwendet wird, um den Wert für den beschleunigten abgelaufenen Teil zu berechnen.
Beachten Sie, dass eine Beschleunigung sowohl auf der Effektstufe als auch der Schlüsselbildstufe (in der Schlüsselbilder die Werte/Zeiten in den MotionPath-Strukturen enthalten) möglich ist. Das Beschleunigungsverhalten baut jeweils aufeinander auf. Der easer
steuert die Beschleunigung des Gesamteffekts. Das Schlüsselbild steuert die Beschleunigung in spezifischen Intervallen der Animation. Standardmäßig ist die Beschleunigung für die Animation nicht linear (Sine(.5)). Die Beschleunigung für Schlüsselbilder ist dagegen linear. Wenn Sie stattdessen einen Effekt mit Beschleunigung auf der Schlüsselbildstufe wünschen, können Sie die Beschleunigung des Effekts auf linear setzen und anschließend die Beschleunigung speziell für die Schlüsselbilder festlegen.
Der Standardwert ist spark.effects.easing.Sine(.5).
Implementierung
public function get easer():IEaser
public function set easer(value:IEaser):void
Verwandte API-Elemente
interpolator | Eigenschaft |
interpolator:IInterpolator
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Interpolator, der von diesem Effekt verwendet wird, um Werte zwischen den Anfangs- und Endwerten einer Eigenschaft zu berechnen. Standardmäßig verarbeitet die NumberInterpolator-Klasse die Interpolation. Wenn die Start- und Endwerte Arrays oder Vektoren sind, wird die Interpolation von der MultiValueInterpolator-Klasse verarbeitet. Die Interpolation von anderen Typen oder von Zahlen, die unterschiedlich zu interpolieren sind (z. B. uint
-Werte mit Farbkanalinformationen), kann verarbeitet werden, indem ein anderer Interpolator verfügbar gemacht wird.
Implementierung
public function get interpolator():IInterpolator
public function set interpolator(value:IInterpolator):void
Verwandte API-Elemente
motionPaths | Eigenschaft |
motionPaths:Vector.<MotionPath>
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ein Vektor von MotionPath-Objekten, die alle den Namen einer zu animierenden Eigenschaft und die während der Animation von der Eigenschaft verwendeten Werte enthalten. Dieser Vektor hat den Vorrang vor allen Eigenschaften, die in den Unterklassen der Animation deklariert sind. Wenn dieses Array beispielsweise direkt für einen Move-Effekt eingestellt wird, werden Eigenschaften des Move-Effekts wie xForm
ignoriert.
Implementierung
public function get motionPaths():Vector.<MotionPath>
public function set motionPaths(value:Vector.<MotionPath>):void
repeatBehavior | Eigenschaft |
repeatBehavior:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Das Verhalten eines sich wiederholenden Effekts, also eines Effekts mit repeatCount
gleich 0 oder > 1. Dieser Wert sollte entweder RepeatBehavior.LOOP
(die Animation wird immer in derselben Reihenfolge wiederholt) oder um RepeatBehavior.REVERSE
(für jede Iteration wird die Richtung der Animation umgekehrt) lauten.
Der Standardwert ist RepeatBehavior.LOOP.
Implementierung
public function get repeatBehavior():String
public function set repeatBehavior(value:String):void
Animate | () | Konstruktor |
effectRepeat | Ereignis |
mx.events.EffectEvent
Eigenschaft EffectEvent.type =
mx.events.EffectEvent.EFFECT_REPEAT
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn der Effekt eine neue Wiederholung beginnt, und zwar für jeden Effekt, der mehr als einmal wiederholt wird. Flex löst gleichzeitig auch ein effectUpdate
-Ereignis für den Effekt aus.
EffectEvent.EFFECT_REPEAT
-Konstante definiert den Wert der type
-Eigenschaft des Ereignisobjekts für ein effectRepeat
-Ereignis.
Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf. |
effectInstance | Das Effektinstanz-Objekt für das Ereignis. |
target | Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget -Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird. |
effectUpdate | Ereignis |
mx.events.EffectEvent
Eigenschaft EffectEvent.type =
mx.events.EffectEvent.EFFECT_UPDATE
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird jedes Mal ausgelöst, wenn der Effekt das Ziel aktualisiert.
DieEffectEvent.EFFECT_UPDATE
-Konstante definiert den Wert der type
-Eigenschaft des Ereignisobjekts für ein effectUpdate
-Ereignis.
Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf. |
effectInstance | Das Effektinstanz-Objekt für das Ereignis. |
target | Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget -Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird. |
<?xml version="1.0"?> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:mx="library://ns.adobe.com/flex/mx" xmlns:s="library://ns.adobe.com/flex/spark"> <fx:Declarations> <s:Animate id="animateEffect" target="{targetBox}" repeatCount="2" repeatBehavior="reverse" disableLayout="true" effectStart="playButton.enabled=false" effectEnd="playButton.enabled=true;"> <s:motionPaths> <s:SimpleMotionPath property="x" valueFrom="0" valueTo="100"/> <s:SimpleMotionPath property="alpha" valueFrom="1" valueTo="0"/> </s:motionPaths> </s:Animate> </fx:Declarations> <s:Panel title="Animate Effect Example" width="75%" height="75%"> <mx:HBox width="100%" height="100%"> <!-- Our target to affect--> <mx:VBox id="targetBox" width="50%" horizontalAlign="center"> <mx:Label text="Nokia 9930" /> <mx:Image id="targetImg" source="@Embed(source='assets/Nokia_6630.png')"/> </mx:VBox> <mx:VBox id="detailsBox" width="50%" left="0"> <mx:Text width="99%" color="blue" text="The Animate effect animates any property or style of an object over time using animationProperty arrays. Click 'Animate' to watch the effect."/> </mx:VBox> </mx:HBox> <s:Rect left="0" right="0" bottom="0" height="30"> <s:fill> <s:LinearGradient rotation="90"> <s:GradientEntry color="0xE2E2E2" /> <s:GradientEntry color="0xD9D9D9" /> </s:LinearGradient> </s:fill> </s:Rect> <s:Button id="playButton" left="5" bottom="5" label="Animate" click="animateEffect.play();"/> </s:Panel> </s:Application>
Tue Jun 12 2018, 10:04 AM Z