Paket | mx.effects |
Klasse | public class TweenEffect |
Vererbung | TweenEffect Effect EventDispatcher Object |
Unterklassen | AnimateProperty, Blur, Dissolve, Fade, Glow, Move, Pause, Resize, Rotate, SeriesEffect, Zoom |
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.Animate als Alternative zu dieser Klasse. TweenEffect ist die Superklasse für animierte Effekte in Flex 3. Ab Flex 4 erweitern die Spark-Effekte die spark.effects.Animate-Klasse anstelle von TweenEffect. |
Die TweenEffect-Klasse ist die Superklasse für alle Effekte, die auf dem Tweenobjekt basieren. Diese Klasse umfasst Methoden und Eigenschaften, die für alle tweenbasierten Effekte verwendet werden können, um eine Duplizierung des Codes an anderen Stellen zu vermeiden.
Sie erstellen eine Unterklasse der TweenEffect-Klasse, um einen Effekt zu definieren, der eine Animation während eines Zeitraums wiedergibt. Der Größenänderungseffekt ändert beispielsweise die Größe des Ziels für einen angegebenen Zeitraum.
MXML-SyntaxMXML-Syntax ausblendenThe <mx:TweenEffect>
tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:TagName Properties easingFunction="easing function name; no default" Events tweenEnd="No default" />
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 | ||
duration : Number
Dauer des Effekts in Millisekunden. | Effect | ||
easingFunction : Function = null
Die Beschleunigungsfunktion für die Animation. | TweenEffect | ||
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 | ||
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 | ||
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 | ||
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 | ||
suspendBackgroundProcessing : Boolean = false
Bei „true“ erfolgt keine Hintergrundverarbeitung, während der Effekt wiedergegeben wird. | 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 | ||
---|---|---|---|
TweenEffect(target:Object = null)
Konstruktor. | TweenEffect | ||
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 |
Methode | Definiert von | ||
---|---|---|---|
Wird intern von der Effektinfrastruktur verwendet. | Effect | ||
Wird aufgerufen, wenn die Wiedergabe einer Effektinstanz abgeschlossen ist. | Effect | ||
Diese Methode wird aufgerufen, wenn die Wiedergabe der Effektinstanz beginnt. | Effect | ||
Wird aufgerufen, wenn eine Effektinstanz durch einen Aufruf der stop()-Methode angehalten wurde. | Effect | ||
Bestimmt die Logik zum Filtern einer Effektinstanz. | Effect | ||
Wird von der captureStartValues()-Methode aufgerufen, um den Wert einer Eigenschaft des Ziels abzurufen. | Effect | ||
Kopiert Eigenschaften des Effekts in die Effektinstanz. | Effect | ||
Wird aufgerufen, wenn der TweenEffect ein TweenEvent auslöst. | TweenEffect |
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 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 ausgelöst, wenn der Tweeneffekt endet. | TweenEffect | |||
Wird beim Start des Tweeneffekts ausgelöst. Dies entspricht dem ersten Aufruf der onTweenUpdate()-Methode. | TweenEffect | |||
Wird jedes Mal ausgelöst, wenn der Tweeneffekt das Ziel aktualisiert. | TweenEffect |
easingFunction | Eigenschaft |
public var easingFunction:Function = null
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Beschleunigungsfunktion für die Animation. Die Beschleunigungsfunktion wird zum Interpolieren zwischen Anfangs- und Zielwert verwendet. 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. Dies ist normalerweise ein Wert zwischen dem Anfangs- und Endwert.
Der Wert dieser Eigenschaft muss ein Funktionsobjekt sein.
Das mx.effects.easing-Paket von Flex enthält einen Satz Beschleunigungsfunktionen.
TweenEffect | () | Konstruktor |
tweenEventHandler | () | Methode |
protected function tweenEventHandler(event:mx.events:TweenEvent):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wird aufgerufen, wenn der TweenEffect ein TweenEvent auslöst. Wenn Sie diese Methode überschreiben, stellen Sie sicher, dass Sie die übergeordnete Methode aufrufen.
Parameter
event:mx.events:TweenEvent — Ein Ereignisobjekt des Typs TweenEvent.
|
tweenEnd | Ereignis |
mx.events.TweenEvent
Eigenschaft TweenEvent.type =
mx.events.TweenEvent.TWEEN_END
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wird ausgelöst, wenn der Tweeneffekt endet. Dieses Ereignis entspricht einem Aufruf der TweenEffectInstance.onTweenEnd()
-Methode.
Wird ein Tweeneffekt ein einziges Mal wiedergegeben, wird dieses Ereignis zur gleichen Zeit wie das effectEnd
-Ereignis ausgeführt. Wird der Tweeneffekt wiederholt, dann wird es nach jeder Wiederholung des Effekts ausgeführt. Das endEffect
-Ereignis wird nach der letzten Wiedergabe des Effekts ausgeführt.
TweenEvent.TWEEN_END
-Konstante definiert den Wert der type
-Eigenschaft des Ereignisobjekts für ein tweenEnd
-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. |
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. |
value | Der an die onTweenEnd() -Methode übergebene Wert. |
tweenStart | Ereignis |
mx.events.TweenEvent
Eigenschaft TweenEvent.type =
mx.events.TweenEvent.TWEEN_START
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wird beim Start des Tweeneffekts ausgelöst. Dies entspricht dem ersten Aufruf der onTweenUpdate()
-Methode. Flex löst gleichzeitig das erste tweenUpdate
-Ereignis für den Effekt aus.
Das Effect.effectStart
-Ereignis wird vor dem tweenStart
-Ereignis ausgelöst.
TweenEvent.TWEEN_START
-Konstante definiert den Wert der type
-Eigenschaft des Ereignisobjekts für ein tweenStart
-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. |
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. |
value | Der an die onTweenEnd() -Methode übergebene Wert. |
tweenUpdate | Ereignis |
mx.events.TweenEvent
Eigenschaft TweenEvent.type =
mx.events.TweenEvent.TWEEN_UPDATE
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wird jedes Mal ausgelöst, wenn der Tweeneffekt das Ziel aktualisiert. Dieses Ereignis entspricht einem Aufruf der TweenEffectInstance.onTweenUpdate()
-Methode.
TweenEvent.TWEEN_UPDATE
-Konstante definiert den Wert der type
-Eigenschaft des Ereignisobjekts für ein tweenUpdate
-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. |
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. |
value | Der an die onTweenEnd() -Methode übergebene Wert. |
<?xml version="1.0"?> <!-- Simple example to demonstrate the TweenEffect class. --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx"> <fx:Script> <![CDATA[ import mx.events.TweenEvent; // Event handler for the tweenUpdate and tweenEnd effects. private function tweenUpdateHandler(event:TweenEvent):void { // Access current width of the image. currentWidth.text="Current width (in pixels): " + String(event.value[0]); } // Event handler for the reset button. private function resetHandler():void { expand.end(); img.width=30; currentWidth.text="Current width (in pixels): 30"; img.height=60; button1.enabled=true; } ]]> </fx:Script> <fx:Declarations> <mx:Resize id="expand" target="{img}" widthTo="100" heightTo="200" duration="10000" tweenUpdate="tweenUpdateHandler(event);" tweenEnd="tweenUpdateHandler(event);"/> </fx:Declarations> <s:Panel title="Resize Effect Example" width="100%" height="100%" > <s:VGroup left="20" right="20" top="20" bottom="20"> <s:Label width="100%" color="blue" text="Use the Button controls to resize the image."/> <s:HGroup width="100%"> <mx:Image id="img" width="30" height="60" source="@Embed(source='assets/Nokia_6630.png')"/> <s:Label id="currentWidth" height="20" width="100%"/> </s:HGroup> <s:Button id="button1" label="Start" click="expand.play(); button1.enabled=false;"/> <s:Button label="Pause" click="expand.pause();"/> <s:Button label="Resume" click="expand.resume();"/> <s:Button label="Reverse" click="expand.reverse();"/> <s:Button label="End" click="expand.end();"/> <s:Button label="Reset" click="resetHandler();"/> </s:VGroup> </s:Panel> </s:Application>
Tue Jun 12 2018, 10:04 AM Z