Tween

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

mx.effects.TweenEffect
mx.effects.effectClasses.TweenEffectInstance

Öffentliche Eigenschaften

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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	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
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		endTween():void Unterbricht das Tween, springt sofort zum Ende des Tweens und ruft die onTweenEnd()-Rückruffunktion auf.	Tween
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		pause():void Hält den Effekt an, bis die resume()-Methode aufgerufen wird.	Tween
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		resume():void Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde.	Tween
		reverse():void Gibt den Effekt rückwärts wieder und beginnt dabei an der aktuellen Position des Effekts.	Tween
		seek(playheadTime:Number):void Lässt den Tweeneffekt an die angegebene Position vorrücken.	Tween
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		setTweenHandlers(updateFunction:Function, endFunction:Function):void 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
		stop():void Hält das Tween an und beendet es, ohne Auslösen eines Ereignisses und ohne Aufrufen der Endfunktion des Tweens oder onTweenEnd().	Tween
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Ereignis		Übersicht	Definiert von
		activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
		deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher

Eigenschaftendetails

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):void

listener

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.

Konstruktordetails

()

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.

Parameter

	`listener: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`) — Dauer der Animation in Millisekunden.

	`minFps:Number` (default = `-1`) — Gibt an, wie oft die `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`) — Legt eine alternative Update-Rückruffunktion fest, die statt `listener.OnTweenUpdate()` verwendet wird.

	`endFunction:Function` (default = `null`) — Legt eine alternative End-Rückruffunktion fest, die statt `listener.OnTweenEnd()` verwendet wird.

Methodendetails

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().

Rechtliche Hinweise | Onlinedatenschutzerklärung

Tween - AS3 Flex

Klassen x

duration

easingFunction

listener

Tween

endTween

pause

resume

reverse

seek

setTweenHandlers

stop