IEffect  - AS3 Flex

Name der Effektklasse wie Fade.

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.

Gibt ein benutzerdefiniertes Filterobjekt des Typs EffectTargetFilter an, das zur Ermittlung der Ziele dient, bei denen der Effekt wiedergegeben wird.

Ziele werden nur gefiltert, wenn Sie die captureStartValues()-Methode aufrufen, bevor Sie den Effekt wiedergeben. Flex ruft die captureStartValues()-Methode automatisch auf, wenn der Effekt zu einem Übergang gehört.

Verwenden Sie die filter-Eigenschaft zum einfachen Filtern. Wenn die customFilter-Eigenschaft einen anderen Wert als null aufweist, wird die filter-Eigenschaft ignoriert.

Der Standardwert ist null.

Verwandte API-Elemente

Dauer des Effekts in Millisekunden.

Bei einem Parallel- oder Sequenzeffekt legt die duration-Eigenschaft die Dauer jedes Effekts fest. Wenn die duration-Eigenschaft eines Sequenzeffekts auf 3000 gesetzt wird, dauert die Wiedergabe jedes Effekts in der Sequenz 3000 Millisekunden.

Bei einem wiederholten Effekt gibt die duration-Eigenschaft die Dauer einer einzigen Instanz des Effekts an. Wenn die duration-Eigenschaft eines Effekts auf 2000 und die repeatCount-Eigenschaft auf 3 gesetzt ist, dauert die Wiedergabe des Effekts insgesamt 6000 Millisekunden (6 Sekunden).

Der Standardwert ist 500.

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.

Gibt einen Algorithmus zum Filtern der Ziele für einen Effekt an. Der Wert null gibt an, dass nicht gefiltert wird.

Ziele werden nur gefiltert, wenn Sie die captureStartValues()-Methode aufrufen, bevor Sie den Effekt wiedergeben. Flex ruft die captureStartValues()-Methode automatisch auf, wenn der Effekt zu einem Übergang oder einem Dateneffekt für ein listenbasiertes Steuerelement gehört.

Verwenden Sie diese Eigenschaft zum einfachen Filtern. Verwenden Sie die customFilter-Eigenschaft für anspruchsvollere Filtervorgänge. Wenn die customFilter-Eigenschaft einen anderen Wert als null aufweist, wird diese Eigenschaft ignoriert.

Sie können die folgenden Werte für die filter-Eigenschaft verwenden:

• Beim Wert "add" wird der Effekt auf jedem Ziel wiedergegeben, das als untergeordnetes Element einem Container hinzugefügt wurde.
• Beim Wert "addItem" wird der Effekt auf dem Elementrenderer für jedes Listenelement wiedergegeben, das einem List- oder TileList-Steuerelement hinzugefügt wurde.
• Beim Wert "hide" wird der Effekt auf jedem Ziel wiedergegeben, dessen visible-Eigenschaft sich von true in false geändert hat.
• Beim Wert "move" wird der Effekt auf jedem Ziel wiedergegeben, dessen x- oder y-Eigenschaft geändert wurde.
• Beim Wert "remove" wird der Effekt auf jedem Ziel wiedergegeben, das als untergeordnetes Element eines Containers entfernt wurde.
• Beim Wert "removeItem" wird der Effekt auf dem Elementrenderer jedes Listenelements wiedergegeben, das aus einem List- oder TileList-Steuerelement entfernt wurde.
• Beim Wert "replacedItem" wird der Effekt auf dem Elementrenderer jedes Listenelements wiedergegeben, das in einem List- oder TileList-Steuerelement durch ein neues Element ersetzt wurde.
• Beim Wert "replacementItem" wird der Effekt auf dem Elementrenderer jedes Listenelements wiedergegeben, das ein vorhandenes Element in einem List- oder TileList-Steuerelement ersetzt.
• Beim Wert "resize" wird der Effekt auf jedem Ziel wiedergegeben, dessen width- oder height-Eigenschaft geändert wurde.
• Beim Wert "show" wird der Effekt auf jedem Ziel wiedergegeben, dessen visible-Eigenschaft sich von false in true geändert hat.
• Der Wert "" gibt an, dass nicht gefiltert wird.

Der Standardwert ist null.

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, fügen Sie Funktionen hinzu, 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.

Ein Flag für den Schreibschutz, das auf „true“ gesetzt ist, wenn Instanzen des Effekts aktuell wiedergegeben werden, und andernfalls auf „false“.

Zusätzliche Verzögerung (in Millisekunden) für Effektziele nach dem ersten Ziel des Effekts. Dieser Wert wird zum Wert der startDelay-Eigenschaft addiert.

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

Ein Array von Eigenschaftsnamen zur Verwendung beim Filtern. Diese Eigenschaft wird intern verwendet und sollte nicht von Effektbenutzern eingestellt werden.

Der Standardwert entspricht dem Array, das von der getAffectedProperties()-Methode zurückgegeben wird.

Ein Array von Stilnamen zur Verwendung beim Filtern. Diese Eigenschaft wird intern verwendet und sollte nicht von Effektbenutzern eingestellt werden.

Der Standardwert entspricht dem Array, das von der getAffectedProperties()-Methode zurückgegeben wird.

Das Objekt, auf das dieser Effekt angewendet wird. Wird ein Effekt durch einen Effekt-Auslöser ausgelöst, wird die target-Eigenschaft automatisch auf das Objekt gesetzt, das den Effekt auslöst.

Ein Array von Objekten, die als Ziele des Effekts verwendet werden können. Bei der Wiedergabe wird der Effekt auf allen Zielen parallel ausgeführt. Durch Einstellen der target-Eigenschaft werden alle Objekte in diesem Array ersetzt. Wenn die targets-Eigenschaft eingestellt wird, gibt die target-Eigenschaft das erste Element in diesem Array zurück.

Der EffectManager übergibt diesem Effekt das Ereignisobjekt, wenn ein Effekt ausgelöst wird, oder null, wenn der Effekt nicht vom EffectManager wiedergegeben wird.

Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts und speichert sie als Endwerte.

Flex ruft die captureEndValues()-Methode automatisch auf, wenn der Effekt zu einem Datenänderungseffekt gehört.

Erfasst die aktuellen Werte der relevanten Eigenschaften eines zusätzlichen Zielsatzes.

Flex verwendet diese Funktion, wenn ein Datenänderungseffekt ausgeführt wird.

Parameter

Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts. Flex ruft die captureStartValues()-Methode automatisch auf, wenn der Effekt zu einem Übergang gehört.

Verwenden Sie diese Funktion, um die Anfangs- und Endwerte des Effekts durch den Effekt selbst ermitteln zu lassen. Die ordnungsgemäße Verwendung der Funktion erfolgt in diesen Schritten:

1. Rufen Sie die captureStartValues()-Methode auf. Der Effekt erfasst die Anfangs- und Endwerte.
2. Ändern Sie die Effektziele, beispielsweise durch Hinzufügen oder Entfernen untergeordneter Elemente, Ändern von Eigenschaften, der Position oder der Größe.
3. Rufen Sie die play()-Methode auf. Der Effekt erfasst die Endwerte. Diese Funktion füllt die EffectInstance.propertyChanges-Eigenschaft für jede Effektinstanz aus, die von diesem Effekt erstellt wird. Effektentwickler können diese propertyChanges-Eigenschaft verwenden, um die Start- und Endwerte für ihren Effekt abzurufen.

Erstellt eine einzelne Effektinstanz und initialisiert sie. Verwenden Sie diese Methode statt der play()-Methode, um die Effektinstanzeigenschaften vor der Wiedergabe der Effektinstanz zu ändern.

Die Effektinstanz wird mit dem in der instanceClass-Eigenschaft angegebenen Typ erstellt. Dann wird sie mit der initInstance()-Methode initialisiert. Wurde die Instanz durch den EffectManager erstellt (wenn der Effekt durch einen Effekt-Auslöser ausgelöst wird), wird der Effekt außerdem durch einen Aufruf der EffectInstance.initEffect() initialisiert.

Durch Aufrufen der createInstance()-Methode wird der Effekt nicht wiedergegeben. Rufen Sie die startEffect()-Methode für die zurückgegebenen Effektinstanz auf.

Diese Funktion wird automatisch von der Effect.play()-Methode aufgerufen.

Parameter

Verwendet ein Array von Zielobjekten und ruft die createInstance()-Methode auf jedem Ziel auf.

Parameter

Entfernt Ereignis-Listener von einer Instanz und entfernt sie aus der Liste der Instanzen.

Parameter

Unterbricht einen aktuell wiedergegebenen Effekt und springt sofort zum Ende des Effekts. Mit dieser Methode wird die EffectInstance.end()-Methode aufgerufen.

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

Wenn Sie eine Effektinstanz als Argument übergeben, wird nur diese Instanz unterbrochen. Wenn kein Argument übergeben wird, werden alle aktuellen Instanzen des Effekts unterbrochen.

Parameter

Verwandte API-Elemente

Gibt ein Array von Strings zurück, wobei jeder String dem Namen einer Eigenschaft entspricht, die von diesem Effekt geändert wird. Beispielsweise gibt der Verschieben-Effekt ein Array zurück, das "x" und "y" enthält.

Jede Unterklasse des Effekts muss diese Methode implementieren. Mit dieser Methode sorgt der EffectManager dafür, dass dieselbe Eigenschaft desselben Objekts nicht durch zwei verschiedene Effekte animiert wird.

Hält den Effekt an, bis die resume()-Methode aufgerufen wird.

Startet die Wiedergabe des Effekts. Normalerweise rufen Sie die end()-Methode vor der play()-Methode auf, um sicherzustellen, dass vorherige Instanzen des Effekts beendet wurden, bevor eine neue gestartet wird.

Alle Unterklassen müssen diese Methode implementieren.

Parameter

Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde.

Gibt den aktuell wiedergegebenen Effekt rückwärts wieder und beginnt dabei an der aktuellen Position des Effekts.

Hält den Effekt an und behält den aktuellen Status der Effektziele bei. Anders als bei der pause()-Methode können Sie nach der stop()-Methode nicht die resume()-Methode aufrufen. Sie können jedoch den Effekt mit der play()-Methode neu starten.

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

Bei Maskierungseffekten wird die Maske beim Anhalten eines Effekts nicht automatisch entfernt. Wenn Sie weitere Maskierungseffekte auf dem gleichen Ziel ausführen, ohne die Maske zuvor zu entfernen, kann es zu unerwarteten Ergebnissen kommen.