| Paket | mx.effects |
| Klasse | public class EffectTargetFilter |
| Vererbung | EffectTargetFilter  Object |
| Unterklassen | AddRemoveEffectTargetFilter, HideShowEffectTargetFilter |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die EffectTargetFilter-Klasse definiert eine defaultFilterFunction()-Methode, die die filterProperties- und diefilterStyles-Eigenschaft verwendet, um zu bestimmen, ob der Effekt auf jedem Effektziel wiedergegeben werden soll.
Sie können auch eine benutzerdefinierte Filterfunktion zum Implementieren Ihrer eigenen Filterlogik erstellen. Definieren Sie dazu die Filterfunktion und geben Sie sie einem EffectTargetFilter-Objekt mithilfe der filterFunction-Eigenschaft an.
Um einen Effekt zur Verwendung eines benutzerdefinierten Filters zu konfigurieren, übergeben Sie ein EffectTargetFilter-Objekt an die Effect.customFilter-Eigenschaft des Effekts.
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| filterFunction : Function
Eine Funktion, die eine benutzerdefinierte Filterlogik festlegt. | EffectTargetFilter | ||
| filterProperties : Array
Ein Array von Strings zur Angabe der Komponenteneigenschaften. | EffectTargetFilter | ||
| filterStyles : Array
Ein Array von Strings zur Angabe der Stileigenschaften. | EffectTargetFilter | ||
| requiredSemantics : Object = null
Eine Reihe von Eigenschaften und zugewiesenen Werten, die zur Wiedergabe des Effekts mit einem Ziel verknüpft werden müssen. | EffectTargetFilter | ||
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | EffectTargetFilter | ||
filterInstance(propChanges:Array, semanticsProvider:mx.effects:IEffectTargetHost, target:Object):Boolean
Bestimmt, ob ein Ziel gefiltert werden soll, wobei „true“ zurückgegeben wird, wenn es in einen Effekt eingeschlossen werden soll. | EffectTargetFilter | ||
|
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 | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
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 | |
| Methode | Definiert von | ||
|---|---|---|---|
Die Standardfilterfunktion für die EffectTargetFilter-Klasse. | EffectTargetFilter | ||
filterFunction | Eigenschaft |
public var filterFunction:Function| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Eine Funktion, die eine benutzerdefinierte Filterlogik festlegt. Flex ruft diese Methode auf jedem Ziel des Effekts auf. Wenn die Funktion true zurückgibt, wird der Effekt auf dem Ziel wiedergegeben; bei false überspringt der Effekt das Ziel. Eine benutzerdefinierte Filterfunktion ermöglicht Ihnen mehr Kontrolle über die Filterung als die Effect.filter-Eigenschaft.
Die Filterfunktion hat folgende Signatur:
filterFunc(propChanges:Array, instanceTarget:Object):Boolean
{
// Return true to play the effect on instanceTarget,
// or false to not play the effect.
}
wobei:
propChanges: Ein Array von PropertyChanges-Objekten, ein Objekt pro Zielkomponente des Effekts. Wenn eine Eigenschaft des Ziels nicht durch den Übergang geändert wird, ist sie nicht in diesem Array enthalten.
instanceTarget: Die Zielkomponente des Effekts, die Sie filtern möchten. Innerhalb der benutzerdefinierten Filterfunktion durchsuchen Sie zuerst das propChanges-Array nach dem PropertyChanges-Objekt, das dem instanceTarget-Argument entspricht, indem Sie das instanceTarget-Argument mit der propChanges.target-Eigenschaft vergleichen.
Verwandte API-Elemente
filterProperties | Eigenschaft |
public var filterProperties:Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein Array von Strings zur Angabe der Komponenteneigenschaften. Wenn sich eine Eigenschaft im Array auf der Zielkomponente geändert hat, wird der Effekt auf dem Ziel wiedergegeben.
Wenn Sie eine benutzerdefinierte Filterfunktion erstellen, können Sie die filterProperties-Eigenschaft innerhalb der Funktion untersuchen.
filterStyles | Eigenschaft |
public var filterStyles:Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein Array von Strings zur Angabe der Stileigenschaften. Wenn sich eine Stileigenschaft im Array auf der Zielkomponente geändert hat, wird der Effekt auf dem Ziel wiedergegeben.
Wenn Sie eine benutzerdefinierte Filterfunktion erstellen, können Sie die filterStyles-Eigenschaft innerhalb der Funktion untersuchen.
requiredSemantics | Eigenschaft |
public var requiredSemantics:Object = null| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Eine Reihe von Eigenschaften und zugewiesenen Werten, die zur Wiedergabe des Effekts mit einem Ziel verknüpft werden müssen.
Bei der Arbeit mit Dateneffekten können Sie mit dieser Eigenschaft Effekte filtern. Wenn Sie einen Dateneffekt auf allen Zielen eines Listensteuerelements wiedergeben möchten, die durch diesen Effekt nicht hinzugefügt werden, das heißt an Zielen, die entfernt, ersetzt, verschoben oder auf andere Art verändert werden, können Sie den Effekt wie folgt definieren:
<mx:Blur>
<mx:customFilter>
<mx:EffectTargetFilter requiredSemantics="{{'added':false}}"/>
</mx:customFilter>
</mx:Blur>
Um einen Dateneffekt auf allen Zielen wiederzugeben, die nicht vom Effekt hinzugefügt oder entfernt werden, können Sie den Effekt wie folgt definieren:
<mx:Blur>
<mx:customFilter>
<mx:EffectTargetFilter requiredSemantics="{{'added':false}, {'removed':false}}"/>
</mx:customFilter>
</mx:Blur>
Zu den zulässigen Eigenschaften, die Sie angeben können, zählen: added, removed, replaced und replacement. Die zulässigen Werte für die Eigenschaften sind true und false.
EffectTargetFilter | () | Konstruktor |
public function EffectTargetFilter()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
defaultFilterFunction | () | Methode |
protected function defaultFilterFunction(propChanges:Array, instanceTarget:Object):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Standardfilterfunktion für die EffectTargetFilter-Klasse. Wenn instanceTarget für einen beliebigen von der filterProperties- oder filterStyles-Eigenschaft angegebenen Wert verschiedene Anfangs- und Endwerte aufweist, wird der Effekt auf dem Ziel wiedergegeben.
Parameter
propChanges:Array — Ein Array von PropertyChanges-Objekten. Die target-Eigenschaft jedes PropertyChanges-Objekts entspricht dem Ziel des Effekts. Wenn eine Eigenschaft des Ziels nicht durch einen Übergang geändert wird, ist das entsprechende PropertyChanges-Objekt nicht in diesem Array enthalten.
| |
instanceTarget:Object — Das EffectInstance-Ziel, das diese Funktion aufruft. Wird ein Effekt auf mehrere Ziele angewendet, wird diese Funktion einmal pro Ziel aufgerufen.
|
Boolean — Gibt true zurück, um die Wiedergabe der Effektinstanz zu ermöglichen.
|
Verwandte API-Elemente
filterInstance | () | Methode |
public function filterInstance(propChanges:Array, semanticsProvider:mx.effects:IEffectTargetHost, target:Object):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Bestimmt, ob ein Ziel gefiltert werden soll, wobei „true“ zurückgegeben wird, wenn es in einen Effekt eingeschlossen werden soll. Der Filter wird angewendet, wenn filterFunction und semanticFilterFunction aufgerufen werden und beide Funktionen „true“ zurückgeben. Die Standardfunktionen mit den Standardwerten geben immer „true“ zurück. Normalerweise verwendet ein EffectTargetFilter nur einen Filtertyp und nicht beide.
Parameter
propChanges:Array — Ein Array von PropertyChanges-Objekten. Die target-Eigenschaft jedes PropertyChanges-Objekts entspricht dem Ziel des Effekts. Wenn eine Eigenschaft des Ziels nicht durch einen Übergang geändert wird, ist das entsprechende PropertyChanges-Objekt nicht in diesem Array enthalten.
| |
semanticsProvider:mx.effects:IEffectTargetHost — Der IEffectTargetHost zum Auswerten der in requiredSemantics angegebenen Eigenschaften für das Ziel, normalerweise der effectTargetHost des Effekts. Wenn die Ziele von Elementänderungseffekten Elementrenderer sind, ist dies die Liste oder TileList mit den Elementrenderern.
| |
target:Object — Das EffectInstance-Ziel, das diese Funktion aufruft. Wird ein Effekt auf mehrere Ziele angewendet, wird diese Funktion einmal pro Ziel aufgerufen.
|
Boolean — Gibt true zurück, wenn das Ziel in den Effekt eingeschlossen werden soll; andernfalls false.
|
Tue Jun 12 2018, 10:04 AM Z