カスタムフィルタ処理を定義する関数を表します。 このメソッドは、エフェクトのすべてのターゲットで呼び出されます。 この関数によって true が返される場合、エフェクトはターゲットで再生されます。false が返される場合、ターゲットはエフェクトによりスキップされます。 カスタムフィルタ関数によって、Effect.filter プロパティを使用する場合に比べ、フィルタリング処理全般をさらに制御できます。

このフィルタ関数のシグネチャは次のとおりです。

      filterFunc(propChanges:Array, instanceTarget:Object):Boolean
      {
          // Return true to play the effect on instanceTarget, 
          // or false to not play the effect.
      } 
      

次に、各指定項目について説明します。

propChanges - PropertyChanges オブジェクトの配列で、エフェクトのターゲットコンポーネントごとに 1 つのオブジェクトを持ちます。 ターゲットのプロパティがトランジションによって変更されない場合、このプロパティはこの配列に含まれません。

instanceTarget - フィルタ処理を実行するエフェクト特有のターゲットコンポーネント。 カスタムフィルタ関数内では、propChanges 配列で instanceTarget 引数と一致する PropertyChanges オブジェクトを最初に検索します（instanceTarget 引数を propChanges.target プロパティと比較して検索します）。

関連項目

コンポーネントプロパティを指定するストリングの配列です。 この配列内のいずれかのプロパティがターゲットコンポーネントで変更された場合、ターゲットでエフェクトを再生します。

カスタムフィルタ関数を定義する場合、関数内から filterProperties プロパティを調べることができます。

スタイルプロパティを指定するストリングの配列です。 配列内のいずれかのスタイルプロパティがターゲットコンポーネントで変更された場合、ターゲットでエフェクトを再生します。

カスタムフィルタ関数を定義する場合、関数内から filterStyles プロパティを調べることができます。

再生されるエフェクトのターゲットに関連付ける必要がある、プロパティと関連する値のコレクションです。

データエフェクトを操作するときに、このプロパティを使用してエフェクトをフィルタ処理できます。 リストコントロールの、エフェクトによって追加されていないすべてのターゲット（つまりその他の方法で削除、置換、移動されたり影響を受けたりするターゲット）でデータエフェクトを再生する場合、次のようにエフェクト定義を作成できます。

      <mx:Blur>
          <mx:customFilter>
              <mx:EffectTargetFilter requiredSemantics="{{'added':false}}"/>
          </mx:customFilter>
      </mx:Blur> 

エフェクトによって追加または削除されていないすべてのターゲットでデータエフェクトを再生する場合、次のようにエフェクト定義を作成できます。

      <mx:Blur>
          <mx:customFilter>
              <mx:EffectTargetFilter requiredSemantics="{{'added':false}, {'removed':false}}"/>
          </mx:customFilter>
      </mx:Blur>

指定できるプロパティのリストには、added、removed、replaced、および replacement が含まれます。プロパティに設定できる値は、true と false です。

コンストラクタです。

EffectTargetFilter クラスのデフォルトのフィルタ関数を表します。 instanceTarget の開始値や終了値が、filterProperties プロパティまたは filterStyles プロパティで指定されたいずれかの値に対して異なる場合は、ターゲットでエフェクトを再生します。

パラメータ

関連項目

ターゲットをフィルタ処理するかどうかを指定します。ターゲットをエフェクトに含める必要がある場合は、true を返します。 この指定は filterFunction と semanticFilterFunction の呼び出しによって行われ、両方の関数が true を返す場合のみ true を返します。 デフォルト値を持つデフォルト関数は常に true を返します。 通常、EffectTargetFilter は一方のフィルタのみを使用し、両方は使用しません。

パラメータ