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 

EffectInstance  - AS3 Flex

Paketmx.effects
Klassepublic class EffectInstance
VererbungEffectInstance Inheritance EventDispatcher Inheritance Object
Implementiert IEffectInstance
Unterklassen ActionEffectInstance, AnimateInstance, CompositeEffectInstance, MaskEffectInstance, SoundEffectInstance, TweenEffectInstance

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

Die EffectInstance-Klasse stellt eine Instanz eines Effekts dar, der auf einem Ziel wiedergegeben wird. Mit jedem Ziel ist eine andere Effektinstanz verknüpft. Die Lebensdauer einer Effektinstanz ist begrenzt. Eine Instanz wird erstellt, wenn ein Effekt auf einem Ziel wiedergegeben wird, und am Ende der Wiedergabe gelöscht. Werden mehrere Effekte auf einem Ziel gleichzeitig wiedergegeben (beispielsweise bei einem Paralleleffekt), dann wird für jeden Effekt eine Effektinstanz erstellt.

Effektentwickler müssen eine Instanzklasse für ihre benutzerdefinierten Effekte erstellen.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  className : 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
  duration : Number
Die Dauer des Effekts in Millisekunden.
EffectInstance
  effect : IEffect
Das IEffect-Objekt, das dieses IEffectInstance-Objekt erstellt hat.
EffectInstance
  effectTargetHost : mx.effects:IEffectTargetHost
Eine Eigenschaft, die Ihnen den Zugriff auf listenbasierte Zielsteuerelemente eines Dateneffekts ermöglicht.
EffectInstance
  hideFocusRing : Boolean
Bestimmt, ob der Effekt den Fokusring beim Start ausblenden soll.
EffectInstance
  playheadTime : Number
Aktuelle Zeitposition des Effekts.
EffectInstance
  propertyChanges : 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
  repeatCount : int
Ein Wert, der angibt, wie oft der Effekt wiederholt werden soll.
EffectInstance
  repeatDelay : int
Wartezeit in Millisekunden vor der Wiederholung des Effekts.
EffectInstance
  startDelay : int
Wartezeit in Millisekunden vor dem Starten des Effekts.
EffectInstance
  suspendBackgroundProcessing : Boolean
Bei „true“ erfolgt keine Hintergrundverarbeitung, während der Effekt wiedergegeben wird.
EffectInstance
  target : Object
Das UIComponent-Objekt, auf das dieser Effekt angewendet wird.
EffectInstance
  triggerEvent : Event
Das Ereignis, falls zutreffend, das die Wiedergabe dieses Effekts ausgelöst hat.
EffectInstance
Geschützte Eigenschaften
 EigenschaftDefiniert von
  playCount : int = 0
Gibt an, wie oft die Instanz wiedergegeben wurde.
EffectInstance
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
EffectInstance
 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
  
Unterbricht eine aktuell wiedergegebene Effektinstanz und springt sofort zum Ende des Effekts.
EffectInstance
  
Wird von der end()-Methode am Ende der Wiedergabe des Effekts aufgerufen.
EffectInstance
  
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
  
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
  
Hält den Effekt an, bis die resume()-Methode aufgerufen wird.
EffectInstance
  
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
  
Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde.
EffectInstance
  
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
  
Gibt die Effektinstanz nach dem startDelay-Zeitraum auf dem Ziel wieder.
EffectInstance
  
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
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

className

Eigenschaft
className:String  [schreibgeschützt]

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

Name der Effektklasse wie FadeInstance.

Dies ist ein kurzer oder „unqualifizierter“ Klassenname, der den Paketnamen nicht einschließt. Wenn Sie den qualifizierten Namen benötigen, verwenden Sie die getQualifiedClassName()-Methode im flash.utils-Paket.



Implementierung
    public function get className():String

duration

Eigenschaft 
duration:Number

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

Die Dauer des Effekts in Millisekunden.



Implementierung
    public function get duration():Number
    public function set duration(value:Number):void

effect

Eigenschaft 
effect:IEffect

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

Das IEffect-Objekt, das dieses IEffectInstance-Objekt erstellt hat.



Implementierung
    public function get effect():IEffect
    public function set effect(value:IEffect):void

effectTargetHost

Eigenschaft 
effectTargetHost:mx.effects:IEffectTargetHost

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

Eine Eigenschaft, die Ihnen den Zugriff auf listenbasierte Zielsteuerelemente eines Dateneffekts ermöglicht. Mit dieser Eigenschaft kann die Instanz einer Effektklasse mit dem listenbasierten Steuerelement kommunizieren, auf dem der Effekt wiedergegeben wird.



Implementierung
    public function get effectTargetHost():mx.effects:IEffectTargetHost
    public function set effectTargetHost(value:mx.effects:IEffectTargetHost):void

hideFocusRing

Eigenschaft 
hideFocusRing:Boolean

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

Bestimmt, ob der Effekt den Fokusring beim Start ausblenden soll. Das Effektziel ist für das Ausblenden des Fokusrings zuständig. Unterklassen der UIComponent-Klasse blenden den Fokusring automatisch aus. Ist das Effektziel keine UIComponent-Klasse, müssen Sie Funktionen hinzufügen, um den Fokusring auszublenden.

Setzen Sie diese Eigenschaft auf true, um den Fokusring während des Effekts auszublenden.

Für Unterklassen der Effect-Klasse lautet der Standardwert false. Für Unterklassen der MaskEffect-Klasse lautet der Standardwert true.



Implementierung
    public function get hideFocusRing():Boolean
    public function set hideFocusRing(value:Boolean):void

playCount

Eigenschaft 
protected var playCount:int = 0

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

Gibt an, wie oft die Instanz wiedergegeben wurde.

playheadTime

Eigenschaft 
playheadTime:Number

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
    public function get playheadTime():Number
    public function set playheadTime(value:Number):void

propertyChanges

Eigenschaft 
propertyChanges:PropertyChanges

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

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. Diese Eigenschaft wird nur eingestellt, wenn die captureStartValues()-Methode des Effekts aufgerufen wurde, der diese Effektinstanz erstellt hat.

Sie verwenden eine propertyChanges-Eigenschaft häufig zum Erstellen eines Effekts, der zu einem Übergang gehört. Flex ruft die captureStartValues()-Methode automatisch auf, wenn der Übergang gestartet wird. In Ihrer Überschreibung der Effectinstance.play()-Methode können Sie diese Informationen in der propertyChanges()-Methode überprüfen, um die Anfangs- und Endwerte des Effekts zu initialisieren.



Implementierung
    public function get propertyChanges():PropertyChanges
    public function set propertyChanges(value:PropertyChanges):void

repeatCount

Eigenschaft 
repeatCount:int

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

Ein Wert, der angibt, wie oft der Effekt wiederholt werden soll. Mögliche Werte sind Ganzzahlen größer als oder gleich 0.



Implementierung
    public function get repeatCount():int
    public function set repeatCount(value:int):void

repeatDelay

Eigenschaft 
repeatDelay:int

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

Wartezeit in Millisekunden vor der Wiederholung des Effekts.



Implementierung
    public function get repeatDelay():int
    public function set repeatDelay(value:int):void

startDelay

Eigenschaft 
startDelay:int

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

Wartezeit in Millisekunden vor dem Starten des Effekts. Mögliche Werte sind Ganzzahlen größer als oder gleich 0. Wird die repeatCount-Eigenschaft zur Wiederholung des Effekts verwendet, wird die startDelay-Eigenschaft nur bei der ersten Wiedergabe des Effekts angewendet.



Implementierung
    public function get startDelay():int
    public function set startDelay(value:int):void

suspendBackgroundProcessing

Eigenschaft 
suspendBackgroundProcessing:Boolean

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

Bei true erfolgt keine Hintergrundverarbeitung, während der Effekt wiedergegeben wird. Zu Hintergrundverarbeitungen zählen Messungen, Layout und Verarbeitung von Serverantworten.



Implementierung
    public function get suspendBackgroundProcessing():Boolean
    public function set suspendBackgroundProcessing(value:Boolean):void

target

Eigenschaft 
target:Object

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

Das UIComponent-Objekt, auf das dieser Effekt angewendet wird.



Implementierung
    public function get target():Object
    public function set target(value:Object):void

triggerEvent

Eigenschaft 
triggerEvent:Event

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

Das Ereignis, falls zutreffend, das die Wiedergabe dieses Effekts ausgelöst hat. Diese Eigenschaft ist nützlich, wenn der Effekt mehreren Auslöser-Ereignissen zugewiesen ist.

Wenn der Effekt programmgesteuert durch einen Aufruf der play()-Methode und nicht durch ein Ereignis ausgelöst wird, ist diese Eigenschaft null.



Implementierung
    public function get triggerEvent():Event
    public function set triggerEvent(value:Event):void
Konstruktordetails

EffectInstance

()Konstruktor
public function EffectInstance(target:Object)

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

Konstruktor.

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

end

()Methode
public function end():void

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

Unterbricht eine aktuell wiedergegebene Effektinstanz und springt sofort zum Ende des Effekts. Diese Methode wird durch die Effect.end()-Methode aufgerufen. Bei ihrer Implementierung ruft sie die finishEffect()-Methode auf.

Die Effektinstanz löst ein effectEnd-Ereignis aus, wenn Sie diese Methode zum Beenden des Effekts aufrufen.

In einer EffectInstance-Unterklasse können Sie diese Methode optional überschreiben. Dabei sollten Sie die super.end()-Methode am Ende der Überschreibung nach der Logik aufrufen.

finishEffect

()Methode 
public function finishEffect():void

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

Wird von der end()-Methode am Ende der Wiedergabe des Effekts aufgerufen. Diese Funktion sendet ein endEffect-Ereignis für das Effektziel.

Sie müssen diese Methode in einer Unterklasse nicht überschreiben. Bei der Verwendung von Effekten brauchen Sie diese Methode nicht aufzurufen. Dagegen kann der Aufruf beim Erstellen einer Effekt-Unterklasse notwendig sein.

finishRepeat

()Methode 
public function finishRepeat():void

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

Wird nach jeder Iteration eines wiederholten Effekts aufgerufen.

Sie müssen diese Methode in einer Unterklasse nicht überschreiben. Sie müssen diese Methode bei der Verwendung von Effekten nicht aufrufen.

initEffect

()Methode 
public function initEffect(event:Event):void

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

Sie wird aufgerufen, wenn der Effekt durch den EffectManager ausgelöst wurde. Diese Basisklassenversion speichert das Ereignis, durch das der Effekt ausgelöst wurde, in der triggerEvent-Eigenschaft. Jede Unterklasse sollte diese Methode überschreiben.

Parameter

event:Event — Das zum Auslösen des Effekts gesendete Ereignisobjekt. Wenn der Auslöser ein mouseDownEffect war, ist das Ereignis ein MouseEvent vom Typ MouseEvent.MOUSEDOWN.

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.

play

()Methode 
public function play():void

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

Gibt die Effektinstanz auf dem Ziel wieder. Rufen Sie stattdessen die startEffect()-Methode auf, um einen Effekt auf einer EffectInstance zu starten.

In einer EffectInstance-Unterklasse müssen Sie diese Methode überschreiben. Die Überschreibung muss die super.play()-Methode aufrufen, damit ein effectStart-Ereignis am Ziel ausgelöst 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.

startEffect

()Methode 
public function startEffect():void

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

Gibt die Effektinstanz nach dem startDelay-Zeitraum auf dem Ziel wieder. Wird von der Effect-Klasse aufgerufen. Verwenden Sie diese Funktion statt der play()-Methode zum Starten einer Effektinstanz.

stop

()Methode 
public function stop():void

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

Hält den Effekt an und behält den aktuellen Status des Ziels bei. Diese Methode wird durch die Effect.stop()-Methode aufgerufen. Bei ihrer Implementierung ruft sie die finishEffect()-Methode auf.

Die Effektinstanz löst ein effectEnd-Ereignis aus, wenn Sie diese Methode zum Beenden des Effekts aufrufen.





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