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...
mx.effects.effectClasses 

TweenEffectInstance  - AS3 Flex

Paketmx.effects.effectClasses
Klassepublic class TweenEffectInstance
VererbungTweenEffectInstance Inheritance EffectInstance Inheritance EventDispatcher Inheritance Object
Unterklassen AnimatePropertyInstance, BlurInstance, DissolveInstance, FadeInstance, GlowInstance, MoveInstance, PauseInstance, ResizeInstance, RotateInstance, SeriesEffectInstance, ZoomInstance

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die TweenEffectInstance-Klasse implementiert die Instanzklasse für den TweenEffect. Flex erstellt eine Instanz dieser Klasse bei der Wiedergabe eines Tweeneffekts. Sie selbst erstellen sie nicht.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedclassName : String
[schreibgeschützt] Name der Effektklasse wie „FadeInstance“.
EffectInstance
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 Inheritedduration : Number
Die Dauer des Effekts in Millisekunden.
EffectInstance
  easingFunction : Function
Die Beschleunigungsfunktion für die Animation.
TweenEffectInstance
 Inheritedeffect : IEffect
Das IEffect-Objekt, das dieses IEffectInstance-Objekt erstellt hat.
EffectInstance
 InheritedeffectTargetHost : mx.effects:IEffectTargetHost
Eine Eigenschaft, die Ihnen den Zugriff auf listenbasierte Zielsteuerelemente eines Dateneffekts ermöglicht.
EffectInstance
 InheritedhideFocusRing : Boolean
Bestimmt, ob der Effekt den Fokusring beim Start ausblenden soll.
EffectInstance
  playheadTime : Number
[override] Aktuelle Zeitposition des Effekts.
TweenEffectInstance
 InheritedpropertyChanges : PropertyChanges
Gibt das PropertyChanges-Objekt an, das die Anfangs- und Endwerte für den Satz Eigenschaften enthält, die für die Ziele des Effekts relevant sind.
EffectInstance
 InheritedrepeatCount : int
Ein Wert, der angibt, wie oft der Effekt wiederholt werden soll.
EffectInstance
 InheritedrepeatDelay : int
Wartezeit in Millisekunden vor der Wiederholung des Effekts.
EffectInstance
 InheritedstartDelay : int
Wartezeit in Millisekunden vor dem Starten des Effekts.
EffectInstance
 InheritedsuspendBackgroundProcessing : Boolean
Bei „true“ erfolgt keine Hintergrundverarbeitung, während der Effekt wiedergegeben wird.
EffectInstance
 Inheritedtarget : Object
Das UIComponent-Objekt, auf das dieser Effekt angewendet wird.
EffectInstance
 InheritedtriggerEvent : Event
Das Ereignis, falls zutreffend, das die Wiedergabe dieses Effekts ausgelöst hat.
EffectInstance
  tween : mx.effects:Tween
Das Tweenobjekt, das die Animation bestimmt.
TweenEffectInstance
Geschützte Eigenschaften
 EigenschaftDefiniert von
 InheritedplayCount : int = 0
Gibt an, wie oft die Instanz wiedergegeben wurde.
EffectInstance
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
TweenEffectInstance
 Inherited
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
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
[override] Unterbricht einen aktuell wiedergegebenen Effekt und springt sofort zum Ende des Effekts.
TweenEffectInstance
 Inherited
Wird von der end()-Methode am Ende der Wiedergabe des Effekts aufgerufen.
EffectInstance
 Inherited
Wird nach jeder Iteration eines wiederholten Effekts aufgerufen.
EffectInstance
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Sie wird aufgerufen, wenn der Effekt durch den EffectManager ausgelöst wurde.
EffectInstance
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
Rückrufmethode, die aufgerufen wird, wenn das Ziel durch den Effekt ein letztes Mal aktualisiert werden soll.
TweenEffectInstance
  
Rückrufmethode, die aufgerufen wird, wenn das Ziel durch den Effekt aktualisiert werden soll.
TweenEffectInstance
 Inherited
Hält den Effekt an, bis die resume()-Methode aufgerufen wird.
EffectInstance
 Inherited
Gibt die Effektinstanz auf dem Ziel wieder.
EffectInstance
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde.
EffectInstance
 Inherited
Gibt den Effekt rückwärts wieder und beginnt dabei an der aktuellen Position des Effekts.
EffectInstance
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Effektinstanz nach dem startDelay-Zeitraum auf dem Ziel wieder.
EffectInstance
 Inherited
Hält den Effekt an und behält den aktuellen Status des Ziels bei.
EffectInstance
 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
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Geschützte Methoden
 MethodeDefiniert von
  
createTween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1):mx.effects:Tween
Erstellt eine Tweeninstanz und weist ihr die Werte für den Anfang, das Ende und die Dauer zu.
TweenEffectInstance
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
Eigenschaftendetails

easingFunction

Eigenschaft
public var easingFunction:Function

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die Beschleunigungsfunktion für die Animation. Standardmäßig verwenden die Effekte die gleiche Beschleunigungsfunktion wie die TweenEffect-Klasse.

Verwandte API-Elemente

playheadTime

Eigenschaft 
playheadTime:Number[override]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Aktuelle Zeitposition des Effekts. Der Wert dieser Eigenschaft liegt zwischen 0 und der Gesamtdauer, die startDelay, repeatCount und repeatDelay einschließt.



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

tween

Eigenschaft 
public var tween:mx.effects:Tween

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das Tweenobjekt, das die Animation bestimmt. Um einen Effekt zu erstellen, müssen Sie eine Tweeninstanz in der Überschreibung der EffectInstance.play()-Methode erstellen und sie der tween-Eigenschaft zuweisen. Verwenden Sie die createTween()-Methode, um das Tweenobjekt zu erstellen.

Konstruktordetails

TweenEffectInstance

()Konstruktor
public function TweenEffectInstance(target:Object)

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Konstruktor.

Parameter
target:Object — Das Objekt, das mit diesem Effekt animiert wird.
Methodendetails

createTween

()Methode
protected function createTween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1):mx.effects:Tween

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Erstellt eine Tweeninstanz und weist ihr die Werte für den Anfang, das Ende und die Dauer zu. Wenn eine Beschleunigungsfunktion angegeben wurde, wird sie der Tweeninstanz zugewiesen. Die Tweeninstanz wird Ereignis-Listenern für die Tween-Ereignisse tweenStart, tweenUpdate und tweenEnd zugewiesen. Normalerweise rufen Sie diese Methode von Ihrer Überschreibung der EffectInstance.play()-Methode aus auf, die den Animationstimer startet.

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 onTweenUpdate()-Methode wird für jedes Intervall der Animation und die zweite onTweenEnd()-Methode 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 ist 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.

Rückgabewerte
mx.effects:Tween — Die neu erstellte Tweeninstanz.

end

()Methode 
override public function end():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Unterbricht einen aktuell wiedergegebenen Effekt und springt sofort zum Ende des Effekts. Ruft die Tween.endTween()-Methode auf der tween-Eigenschaft auf. Diese Methode implementiert die Methoden der Superklasse.

Wenn Sie eine Unterklasse der TweenEffectInstance erstellen, können Sie diese Methode optional überschreiben.

Der Effekt löst das effectEnd-Ereignis aus.

Verwandte API-Elemente

onTweenEnd

()Methode 
public function onTweenEnd(value:Object):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Rückrufmethode, die aufgerufen wird, wenn das Ziel durch den Effekt ein letztes Mal aktualisiert werden soll. Die Tween-Klasse übergibt Tween.endValue als Wert des value-Arguments. Das value-Argument kann entweder eine Zahl oder ein Array von Zahlen sein.

Das Überschreiben dieser Funktion ist optional. Sie müssen außerdem die übergeordnete Version dieser Methode am Ende der Überschreibung, super.onTweenEnd(val), nach der Logik aufrufen.

Parameter

value:Object — Der Wert des value-Arguments ist ein interpolierter Wert, der durch die Tween.startValue-Eigenschaft, die Tween.endValue-Eigenschaft und die Interpolationsfunktion bestimmt wird, die von der Implementierung des Effekts in dessen play()-Methode angegeben wird. Die play()-Methode verwendet diese Werte zum Erstellen eines Tweenobjekts, das den Effekt für einen bestimmten Zeitraum wiedergibt. Das value-Argument kann entweder eine Zahl oder ein Array von Zahlen sein.

onTweenUpdate

()Methode 
public function onTweenUpdate(value:Object):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Rückrufmethode, die aufgerufen wird, wenn das Ziel durch den Effekt aktualisiert werden soll. Die Tween-Klasse verwendet die Beschleunigungsfunktion und die Tween.startValue-, Tween.endValue- und Tween.duration-Eigenschaft, um den Wert des value-Arguments zu berechnen. Das value-Argument kann entweder eine Zahl oder ein Array von Zahlen sein.

Alle Unterklassen müssen diese Methode überschreiben. Es ist nicht unbedingt erforderlich, beim Überschreiben dieser Methode die übergeordnete Version dieser Funktion aufzurufen.

Parameter

value:Object — Der Wert des value-Arguments ist ein interpolierter Wert, der durch die Tween.startValue-Eigenschaft, die Tween.endValue-Eigenschaft und die Interpolationsfunktion bestimmt wird, die von der Implementierung des Effekts in dessen play()-Methode angegeben wird. Die play()-Methode verwendet diese Werte zum Erstellen eines Tweenobjekts, das den Effekt für einen bestimmten Zeitraum wiedergibt. Das value-Argument kann entweder eine Zahl oder ein Array von Zahlen sein.





[ 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.