TweenEffect

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-Syntax expanded

MXML-Syntax ausblenden

The <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"
  />

Beispiele anzeigen

Verwandte API-Elemente

mx.effects.Tween
mx.effects.effectClasses.TweenEffectInstance

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	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

Geschützte Eigenschaften

Vererbte geschützte Eigenschaften ausblenden

Vererbte geschützte Eigenschaften anzeigen

	Eigenschaft		Definiert von
		applyTransitionEndProperties : Boolean Dieses Flag steuert, ob der Effekt, wenn er in einem Übergang ausgeführt wird, automatisch die Eigenschaftswerte des Endstatus anwendet, statt die durch den Effekt eingestellten Werte beizubehalten.	Effect
		endValuesCaptured : Boolean = false Wenn dieses Flag auf „true“ gesetzt ist, wurden die Werte eines Effekts bereits bestimmt. Bei „false“ werden die Werte beim Ausführen des Effekts aus den aktuellen Eigenschaften der Effektziele übernommen.	Effect

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	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
		captureEndValues():void Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts und speichert sie als Endwerte.	Effect
		captureMoreStartValues(targets:Array):void Erfasst die aktuellen Werte der relevanten Eigenschaften eines zusätzlichen Zielsatzes. Flex verwendet diese Funktion, wenn ein Datenänderungseffekt ausgeführt wird.	Effect
		captureStartValues():void Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts.	Effect
		createInstance(target:Object = null):IEffectInstance Erstellt eine einzelne Effektinstanz und initialisiert sie.	Effect
		createInstances(targets:Array = null):Array Verwendet ein Array von Zielobjekten und ruft die createInstance()-Methode auf jedem Ziel auf.	Effect
		deleteInstance(instance:IEffectInstance):void Entfernt Ereignis-Listener von einer Instanz und entfernt sie aus der Liste der Instanzen.	Effect
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		end(effectInstance:IEffectInstance = null):void Unterbricht einen aktuell wiedergegebenen Effekt und springt sofort zum Ende des Effekts.	Effect
		getAffectedProperties():Array Gibt ein Array von Strings zurück, wobei jeder String dem Namen einer Eigenschaft entspricht, die von diesem Effekt geändert wird.	Effect
		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.	Effect
		play(targets:Array = null, playReversedFromEnd:Boolean = false):Array Startet die Wiedergabe des Effekts.	Effect
		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.	Effect
		reverse():void Gibt den aktuell wiedergegebenen Effekt rückwärts wieder und beginnt dabei an der aktuellen Position des Effekts.	Effect
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		stop():void Hält den Effekt an und behält den aktuellen Status der Effektziele bei.	Effect
		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

Geschützte Methoden

Vererbte geschützte Methoden ausblenden

Vererbte geschützte Methoden anzeigen

	Methode		Definiert von
		applyValueToTarget(target:Object, property:String, value:*, props:Object):void Wird intern von der Effektinfrastruktur verwendet.	Effect
		effectEndHandler(event:EffectEvent):void Wird aufgerufen, wenn die Wiedergabe einer Effektinstanz abgeschlossen ist.	Effect
		effectStartHandler(event:EffectEvent):void Diese Methode wird aufgerufen, wenn die Wiedergabe der Effektinstanz beginnt.	Effect
		effectStopHandler(event:EffectEvent):void Wird aufgerufen, wenn eine Effektinstanz durch einen Aufruf der stop()-Methode angehalten wurde.	Effect
		filterInstance(propChanges:Array, target:Object):Boolean Bestimmt die Logik zum Filtern einer Effektinstanz.	Effect
		getValueFromTarget(target:Object, property:String):* Wird von der captureStartValues()-Methode aufgerufen, um den Wert einer Eigenschaft des Ziels abzurufen.	Effect
		initInstance(instance:IEffectInstance):void Kopiert Eigenschaften des Effekts in die Effektinstanz.	Effect
		tweenEventHandler(event:mx.events:TweenEvent):void Wird aufgerufen, wenn der TweenEffect ein TweenEvent auslöst.	TweenEffect

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Ü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
effectEnd	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
effectStart	Wird ausgelöst, wenn die Wiedergabe eines Effekts gestartet wird.	Effect
effectStop	Wird ausgelöst, wenn der Effekt angehalten wurde. Dies geschieht nur, wenn der Effekt durch Aufrufen der stop()-Methode unterbrochen wird.	Effect
tweenEnd	Wird ausgelöst, wenn der Tweeneffekt endet.	TweenEffect
tweenStart	Wird beim Start des Tweeneffekts ausgelöst. Dies entspricht dem ersten Aufruf der onTweenUpdate()-Methode.	TweenEffect
tweenUpdate	Wird jedes Mal ausgelöst, wenn der Tweeneffekt das Ziel aktualisiert.	TweenEffect

Eigenschaftendetails

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.

Konstruktordetails

()

Konstruktor

public function TweenEffect(target:Object = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Parameter

target:Object (default = null) — Das Objekt, das mit diesem Effekt animiert wird.

Methodendetails

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.

Ereignisdetails

tweenEnd

Ereignis

Ereignisobjekttyp: 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.

Die 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

Ereignisobjekttyp: 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.

Die 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

Ereignisobjekttyp: 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.

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

Beispiele Verwendung dieses Beispiels

SimpleTweenEffectExample.mxml

<?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>

Rechtliche Hinweise | Onlinedatenschutzerklärung

TweenEffect - AS3 Flex

Klassen x

easingFunction

TweenEffect

tweenEventHandler

tweenEnd

tweenStart

tweenUpdate