EffectTargetFilter  - AS3 Flex

カスタムフィルター処理を定義する関数を表します。 このメソッドは、エフェクトのすべてのターゲットで呼び出されます。 この関数によって 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 プロパティと比較して検索します）。

関連する API エレメント

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

カスタムフィルター関数を定義する場合、関数内から 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 プロパティで指定されたいずれかの値に対して異なる場合は、ターゲットでエフェクトを再生します。

パラメーター

関連する API エレメント

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

パラメーター