ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
spark.effects.animation 

Animation  - AS3 Flex

Paketspark.effects.animation
Klassepublic final class Animation
VererbungAnimation Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Animation-Klasse definiert eine Animation, die zwischen dem Start- und Endwert einer Eigenschaft über einen angegebenen Zeitraum auftritt. Bei der Animation kann es sich um eine Änderung der Position durch den Move-Effekt; eine Änderung der Größe durch den Resize-Effekt; eine Änderung der Sichtbarkeit durch den Fade-Effekt; oder andere Typen von Animationen handeln, die von Effekten verwendet oder direkt mit der Animation-Klasse ausgeführt werden.

Diese Klasse definiert die Zeit und den Wert der Animation. In weiterem Code, entweder in Effekten oder in Anwendungscode, wird die Animation mit Zielobjekten und Eigenschaften verknüpft, sodass die animierten Werte, die von der Animation-Klasse produziert werden, anschließend auf die Zielobjekte und Eigenschaften angewendet werden können, was letztendlich dazu führt, dass diese Objekte animiert werden.

Wenn Sie Animationseffekte definieren, erstellen Sie normalerweise eine Instanz der Animate-Klasse oder eine Unterklasse der Animation. Auf diese Weise wird eine Animation-Instanz in der play()-Methode erstellt. Die Animation-Instanz akzeptiert Start- und Endwerte, eine Dauer und optionale Parameter wie easer- und interpolator-Objekte.

Das Animation-Objekt ruft am Anfang und Ende der Animation, wenn die Animation wiederholt wird sowie in regelmäßigen Aktualisierungsintervallen während der Animation, Ereignis-Listener auf. Bei diesen Aufrufen werden Werte übergeben, die von der Animation-Instanz auf Grundlage der Anfangs- und Endwerte sowie der easer- und interpolator-Objekte berechnet wurden. Diese Werte können anschließend verwendet werden, um Eigenschaftswerte für Zielobjekte einzustellen.

Standard-MXML-EigenschaftmotionPaths

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  animationTarget : spark.effects.animation:IAnimationTarget
Das IAnimationTarget-Objekt, das bei allen start-, end-, repeat- und update-Ereignissen für diese Animation benachrichtigt wird.
Animation
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  currentValue : Object
Ein Objekt, das die berechneten Werte als aktuelles Bild der Animation enthält.
Animation
  cycleFraction : Number
[schreibgeschützt] Der aktuell abgelaufene Teil der Animation, nachdem die Beschleunigung angewendet wurde.
Animation
  cycleTime : Number
[schreibgeschützt] Die aktuelle Position der Millisekunden im aktuellen Animationszyklus.
Animation
  duration : Number = 500
Die Länge der Animation in Millisekunden, wobei die durch die repeatCount-Eigenschaft definierten Wiederholungen nicht berücksichtigt werden.
Animation
  easer : IEaser
Das Beschleunigungsverhalten für diesen Effekt.
Animation
  interpolator : IInterpolator = null
Der Interpolator, der von der Animation-Instanz verwendet wird, um Werte zwischen dem Anfangs- und Endwert der Eigenschaft zu berechnen.
Animation
  isPlaying : Boolean
[schreibgeschützt] Bei „true“ wird die Animation gerade abgespielt.
Animation
  motionPaths : Vector.<MotionPath>
Die Gruppe von MotionPath-Objekten, die die Eigenschaften und Werte definiert, die die Animation über einen bestimmten Zeitraum animiert.
Animation
  playheadTime : Number
Die verstrichene Gesamtzeit der Animation einschließlich Startverzögerung und Wiederholungen.
Animation
  playReversed : Boolean
Bei „true“ wird die Animation umgekehrt abgespielt.
Animation
  repeatBehavior : String
Legt das Verhalten einer sich wiederholenden Animation fest.
Animation
  repeatCount : int
Die Anzahl an Wiederholungen für diese Animation.
Animation
  repeatDelay : Number
Die Dauer (in Millisekunden) der Verzögerung, bevor der nächste Wiederholungszyklus beginnt.
Animation
  startDelay : Number
Die Wartezeit, bevor die Animation beginnt.
Animation
Öffentliche Methoden
 MethodeDefiniert von
  
Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null)
Konstruktor.
Animation
  
Unterbricht die Animation, wechselt unmittelbar an das Ende der Animation und ruft die animationEnd()-Funktion auf dem animationTarget auf.
Animation
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
Hält die Animation an, bis die resume()-Methode aufgerufen wird.
Animation
  
Starten Sie die Animation.
Animation
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde.
Animation
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
Stoppt die Animation und beendet sie, ohne die end()-Methode aufzurufen.
Animation
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

animationTarget

Eigenschaft
animationTarget:spark.effects.animation:IAnimationTarget

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Das IAnimationTarget-Objekt, das bei allen start-, end-, repeat- und update-Ereignissen für diese Animation benachrichtigt wird. Der Wert null gibt an, dass kein Ziel zu benachrichtigen ist.

Der Standardwert ist null.



Implementierung
    public function get animationTarget():spark.effects.animation:IAnimationTarget
    public function set animationTarget(value:spark.effects.animation:IAnimationTarget):void

currentValue

Eigenschaft 
public var currentValue:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Ein Objekt, das die berechneten Werte als aktuelles Bild der Animation enthält. Die Werte werden als Matrixwerte gespeichert, wobei Eigenschaftsnamen als Schlüssel verwendet werden.

cycleFraction

Eigenschaft 
cycleFraction:Number  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Der aktuell abgelaufene Teil der Animation, nachdem die Beschleunigung angewendet wurde. Dieser Wert liegt zwischen 0 und 1. Als ein Zyklus einer Animation gilt eine einzige Wiederholung der Animation. Die repeatCount-Eigenschaft legt die Anzahl der abgespielten Zyklen fest.



Implementierung
    public function get cycleFraction():Number

cycleTime

Eigenschaft 
cycleTime:Number  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die aktuelle Position der Millisekunden im aktuellen Animationszyklus. Dieser Wert liegt zwischen 0 und duration. Als ein Zyklus einer Animation gilt eine einzige Wiederholung der Animation. Die repeatCount-Eigenschaft legt die Anzahl der abgespielten Zyklen fest. Verwenden Sie die seek()-Methode zum Ändern der Position der Animation.



Implementierung
    public function get cycleTime():Number

duration

Eigenschaft 
public var duration:Number = 500

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Länge der Animation in Millisekunden, wobei die durch die repeatCount-Eigenschaft definierten Wiederholungen nicht berücksichtigt werden.

Der Standardwert ist 500.

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.

Der Wert null gibt an, dass keine Beschleunigung verwendet wird, was einer linearen Beschleunigung entspricht (animation.easer = Linear.getInstance();).

Der Standardwert ist Sine(.5).



Implementierung
    public function get easer():IEaser
    public function set easer(value:IEaser):void

interpolator

Eigenschaft 
public var interpolator:IInterpolator = null

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Der Interpolator, der von der Animation-Instanz verwendet wird, um Werte zwischen dem Anfangs- und Endwert der Eigenschaft zu berechnen. Standardmäßig verwendet die Klasse die NumberInterpolator-Klasse. Wenn die Start- und Endwerte Arrays oder Vektoren sind, wird die Interpolation von der MultiValueInterpolator-Klasse verarbeitet. Die Interpolation von anderen Datentypen oder von Zahlen, die unterschiedlich zu interpolieren sind (z. B. uint-Werte mit Farbkanalinformationen), können verarbeitet werden, indem ein anderer Interpolator verfügbar gemacht wird.

Verwandte API-Elemente

isPlaying

Eigenschaft 
isPlaying:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Bei true wird die Animation gerade abgespielt. Der Wert ist auf false eingestellt, es sei denn, die Animation wurde abgespielt und noch nicht gestoppt (entweder programmgesteuert oder automatisch) oder angehalten.

Der Standardwert ist false.



Implementierung
    public function get isPlaying():Boolean

motionPaths

Eigenschaft 
public var motionPaths:Vector.<MotionPath>

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Gruppe von MotionPath-Objekten, die die Eigenschaften und Werte definiert, die die Animation über einen bestimmten Zeitraum animiert.

Verwandte API-Elemente

playheadTime

Eigenschaft 
playheadTime:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die verstrichene Gesamtzeit der Animation einschließlich Startverzögerung und Wiederholungen. Bei einer Animation, deren erster Zyklus abgespielt wird, entspricht dieser Wert dem Wert für cycleTime.



Implementierung
    public function get playheadTime():Number
    public function set playheadTime(value:Number):void

playReversed

Eigenschaft 
playReversed:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Bei true wird die Animation umgekehrt abgespielt. Wenn die Animation derzeit in der entgegengesetzten Richtung des angegebenen Werts von playReversed abgespielt wird, ändert die Animation die Richtung dynamisch.

Der Standardwert ist false.



Implementierung
    public function get playReversed():Boolean
    public function set playReversed(value:Boolean):void

repeatBehavior

Eigenschaft 
repeatBehavior:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt das Verhalten einer sich wiederholenden Animation fest. Für eine sich wiederholende Animation ist die repeatCount-Eigenschaft auf 0 oder einen Wert größer als 1 eingestellt. Bei diesem Wert sollte es sich entweder um RepeatBehavior.LOOP (die Animation wird immer in derselben Reihenfolge wiederholt) oder um RepeatBehavior.REVERSE (für jede Iteration wird die Richtung der Animation umgekehrt) handeln.

Der Standardwert ist RepeatBehavior.LOOP.



Implementierung
    public function get repeatBehavior():String
    public function set repeatBehavior(value:String):void

Verwandte API-Elemente

repeatCount

Eigenschaft 
repeatCount:int

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Anzahl an Wiederholungen für diese Animation. Bei einem Wert von 0 wird sie unendlich oft abgespielt.

Der Standardwert ist 1.



Implementierung
    public function get repeatCount():int
    public function set repeatCount(value:int):void

repeatDelay

Eigenschaft 
repeatDelay:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Dauer (in Millisekunden) der Verzögerung, bevor der nächste Wiederholungszyklus beginnt. Indem dieser Wert auf eine Zahl ungleich null eingestellt wird, wird der vorherige Animationszyklus genau am Endwert beendet. Nicht verzögerte Wiederholungen können diesen Wert jedoch vollständig überspringen, da die Animation glatt vom Ende eines Zyklus auf den Anfang des nächsten Zyklus übergeht. Diese Eigenschaft muss einen Wert >= 0 aufweisen.

Diese Eigenschaft wird für die erste Wiederholung nach dem ersten Animationszyklus verwendet. Um den ersten Zyklus der Animation zu verzögern, verwenden Sie die startDelay-Eigenschaft.

Der Standardwert ist 0.



Implementierung
    public function get repeatDelay():Number
    public function set repeatDelay(value:Number):void

Verwandte API-Elemente

startDelay

Eigenschaft 
startDelay:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Wartezeit, bevor die Animation beginnt. Diese Eigenschaft muss einen Wert >= 0 aufweisen.

Der Standardwert ist 0.



Implementierung
    public function get startDelay():Number
    public function set startDelay(value:Number):void
Konstruktordetails

Animation

()Konstruktor
public function Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null)

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Konstruktor. Die optionalen Parameter property, startValue und endValue definieren eine einfache Animation mit einem einzigen MotionPath-Objekt mit zwei Schlüsselbildern. Wenn einer der Werte ungleich null ist, wird startValue zu value des ersten KeyFrames, wobei „time“ = 0, und endValue zum value des zweiten KeyFrames am Ende der Animation.

Parameter
duration:Number (default = 500) — Die Länge der Animation in Millisekunden.
 
property:String (default = null) — Die zu animierende Eigenschaft.
 
startValue:Object (default = null) — Der Ausgangswert der Eigenschaft.
 
endValue:Object (default = null) — Der letzte Wert der Eigenschaft.
Methodendetails

end

()Methode
public function end():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Unterbricht die Animation, wechselt unmittelbar an das Ende der Animation und ruft die animationEnd()-Funktion auf dem animationTarget auf.

pause

()Methode 
public function pause():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Hält den Effekt an, bis die resume()-Methode aufgerufen wird. Wenn stop() vor resume() aufgerufen wird, kann die Animation nicht fortgesetzt werden.

play

()Methode 
public function play():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Starten Sie die Animation. Wenn die Animation bereits abgespielt wird, wird sie zunächst gestoppt und danach weiter abgespielt.

resume

()Methode 
public function resume():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde.

stop

()Methode 
public function stop():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Stoppt die Animation und beendet sie, ohne die end()-Methode aufzurufen. Die animationStop()-Funktion auf dem animationTarget wird aufgerufen.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.