| Paket | mx.effects |
| Klasse | public class Tween |
| Vererbung | Tween  EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
 | Beginnend mit Flex 4.0 empfiehlt Adobe die Verwendung der Klasse spark.effects.animation.Animation als Alternative zu dieser Klasse. Tween ist die zugrunde liegende Animationsklasse für Effekte in Flex 3. Ab Flex 4 verwenden die Spark-Effekte die spark.effects.animation.Animation-Klasse, die eine ähnliche Funktionalität bietet. |
Die Tween-Klasse definiert ein Tween, eine Eigenschaftsanimation, die auf einem Zielobjekt über einen Zeitraum hinweg wiedergegeben wird. Die Animation kann eine Positionsänderung wie beim Verschieben-Effekt, eine Größenänderung wie beim Zoomeffekt oder Größenänderungseffekt, eine Sichtbarkeitsänderung wie beim Effekt „Ein-und ausblenden“ oder Auflösungseffekt oder andere Animationstypen umfassen.
Bei der Definition von Tweeneffekten erstellen Sie normalerweise eine Instanz der Tween-Klasse innerhalb Ihrer Überschreibung der EffectInstance.play()-Methode. Eine Tweeninstanz akzeptiert die Eigenschaften startValue, endValue und duration und eine optionale Beschleunigungsfunktion zum Definieren der Animation.
Das Tweenobjekt ruft während der Dauer des Effekts regelmäßig die mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate()-Rückruffunktion der Effektinstanz auf und übergibt der onTweenUpdate()-Methode einen interpolierten Wert zwischen startValue und endValue. Normalerweise aktualisiert die Rückruffunktion eine Eigenschaft des Zielobjekts, um das Objekt während der Effektdauer zu animieren.
Am Ende des Effekts rufen Tweenobjekte die mx.effects.effectClasses.TweenEffectInstance.onTweenEnd()-Rückruffunktion auf, wenn Sie eine solche definiert haben.
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| duration : Number = 3000
Dauer der Animation in Millisekunden. | Tween | ||
| easingFunction : Function [Nur Schreiben]
Stellt die Beschleunigungsfunktion für die Animation ein. | Tween | ||
| listener : Object
Objekt, das bei jedem Intervall der Animation benachrichtigt wird. | Tween | ||
| Methode | Definiert von | ||
|---|---|---|---|
Tween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1, updateFunction:Function = null, endFunction:Function = null)
Konstruktor. | Tween | ||
| 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 | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
Unterbricht das Tween, springt sofort zum Ende des Tweens und ruft die onTweenEnd()-Rückruffunktion auf. | Tween | ||
|
Ü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. | Tween | ||
|
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. | Tween | ||
Gibt den Effekt rückwärts wieder und beginnt dabei an der aktuellen Position des Effekts. | Tween | ||
Lässt den Tweeneffekt an die angegebene Position vorrücken. | Tween | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
Standardmäßig ruft die Tween-Klasse die mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate()-Rückruffunktion der Effektinstanz in regelmäßigen Abständen während der Effektwiedergabe auf. Nach der Effektwiedergabe ruft sie die optionale mx.effects.effectClasses.TweenEffectInstance.onTweenEnd()-Rückruffunktion auf. | Tween | ||
Hält das Tween an und beendet es, ohne Auslösen eines Ereignisses und ohne Aufrufen der Endfunktion des Tweens oder onTweenEnd(). | Tween | ||
|
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 | |
duration | Eigenschaft |
public var duration:Number = 3000| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Dauer der Animation in Millisekunden.
easingFunction | Eigenschaft |
easingFunction:Function [Nur Schreiben] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Stellt die Beschleunigungsfunktion für die Animation ein. Die Beschleunigungsfunktion dient zum Interpolieren zwischen startValue- und endValue-Wert. Eine einfache Beschleunigungsfunktion interpoliert linear, anspruchsvollere Beschleunigungsfunktionen erwecken den Eindruck von Beschleunigung und Verlangsamung und lassen die Animation so natürlicher erscheinen.
Wenn keine Beschleunigungsfunktion angegeben wird, wird eine Beschleunigungsfunktion auf der Basis der Math.sin()-Methode verwendet.
Die Beschleunigungsfunktion setzt die durch Robert Penner bekannt gewordene Funktionssignatur ein. Die Funktion akzeptiert vier Argumente. Das erste Argument ist die „aktuelle Zeit“, wobei die Startzeit der Animation 0 entspricht. Das zweite Argument ist der Wert am Anfang der Animation (eine Zahl). Das dritte Argument ist der Endwert abzüglich des Anfangswerts. Das vierte Argument ist die Dauer der Animation. Der Rückgabewert ist der interpolierte Wert für die aktuelle Zeit (normalerweise ein Wert zwischen dem Anfangs- und Endwert).
Das mx.effects.easing-Paket von Flex enthält einen Satz Beschleunigungsfunktionen.
Implementierung
public function set easingFunction(value:Function):voidlistener | Eigenschaft |
public var listener:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Objekt, das bei jedem Intervall der Animation benachrichtigt wird.
Tween | () | Konstruktor |
public function Tween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1, updateFunction:Function = null, endFunction:Function = null)| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
Wenn der Konstruktor aufgerufen wird, beginnt automatisch die Wiedergabe der Animation.
Parameterlistener:Object — Objekt, das bei jedem Intervall der Animation benachrichtigt wird. Normalerweise übergeben Sie das this-Schlüsselwort als Wert. Der listener muss die onTweenUpdate()-Methode und optional die onTweenEnd()-Methode definieren. Die erste Methode wird für jedes Intervall der Animation und die zweite nur nach Beendigung der Animation aufgerufen.
| |
startValue:Object — Wert(e) am Anfang der Animation. Entweder eine Zahl oder ein Array von Zahlen. Bei Übergabe einer Zahl interpoliert Tween zwischen dieser und der im endValue-Parameter übergebenen Zahl. Bei Übergabe von einem Array von Zahlen wird jede Zahl im Array interpoliert.
| |
endValue:Object — Wert(e) am Ende der Animation. Der Typ dieses Arguments muss dem startValue-Parameter entsprechen.
| |
duration:Number (default = -1) | |
minFps:Number (default = -1)onTweenUpdate()-Methode pro Sekunde mindestens aufgerufen werden muss. Der Tweencode versucht, die onTweenUpdate()-Methode so oft wie möglich (bis zu 100 Mal pro Sekunde) aufzurufen. Wenn die Häufigkeit jedoch unter minFps sinkt, wird die Animation automatisch verlängert. Wenn eine Animation also an einer bestimmten Stelle vorübergehend zum Stillstand kommt (da nicht genügend CPU-Zyklen zur Verfügung stehen), wird sie an dieser Stelle fortgesetzt und plötzliche Sprünge werden vermieden.
| |
updateFunction:Function (default = null)listener.OnTweenUpdate() verwendet wird.
| |
endFunction:Function (default = null)listener.OnTweenEnd() verwendet wird.
|
endTween | () | Methode |
public function endTween():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Unterbricht das Tween, springt sofort zum Ende des Tweens und ruft die onTweenEnd()-Rückruffunktion auf.
pause | () | Methode |
public function pause():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Hält den Effekt an, bis die resume()-Methode aufgerufen wird.
resume | () | Methode |
public function resume():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde.
reverse | () | Methode |
public function reverse():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt den Effekt rückwärts wieder und beginnt dabei an der aktuellen Position des Effekts.
seek | () | Methode |
public function seek(playheadTime:Number):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Lässt den Tweeneffekt an die angegebene Position vorrücken.
Parameter
playheadTime:Number — Die Position (in Millisekunden) zwischen 0 und dem Wert der duration-Eigenschaft.
|
setTweenHandlers | () | Methode |
public function setTweenHandlers(updateFunction:Function, endFunction:Function):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Standardmäßig ruft die Tween-Klasse die mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate()-Rückruffunktion der Effektinstanz regelmäßig während der Effektwiedergabe und die optionale mx.effects.effectClasses.TweenEffectInstance.onTweenEnd()-Rückruffunktion nach der Effektwiedergabe auf.
Auf diese Art können Sie verschiedene Methoden als Update- und End-Rückruffunktionen festlegen.
Parameter
updateFunction:Function — Legt die Update-Rückruffunktion fest.
| |
endFunction:Function — Legt die End-Rückruffunktion fest.
|
stop | () | Methode |
public function stop():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Hält das Tween an und beendet es, ohne Auslösen eines Ereignisses, Aufrufen der Endfunktion des Tweens oder onTweenEnd().
Tue Jun 12 2018, 10:04 AM Z