EffectTargetFilter  - AS3 Flex

Функция, определяющая пользовательскую логику фильтрации. 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, по одному объекту на каждый целевой компонент эффекта. Если свойство целевого объекта при переходе не изменяется, соответствующий объект в этот массив не включается.

instanceTarget – определенный целевой компонент эффекта, который требуется отфильтровать. В пользовательской функции фильтрации сначала в массиве propChanges осуществляется поиск объекта PropertyChanges, соответствующего аргументу instanceTarget, путем сравнения аргумента instanceTarget со свойством propChanges.target.

Связанные элементы API

Массив строк, определяющий свойства компонента. Если какое-либо из указанных в массиве свойств в целевом компоненте изменяется, воспроизводится эффект для целевого объекта.

Если определена пользовательская функция фильтрации, свойство filterProperties можно проанализировать в этой функции.

Массив строк, определяющий свойства стиля. Если какое-либо из указанных в массиве свойств стиля в целевом компоненте изменяется, воспроизводится эффект для целевого объекта.

Если определена пользовательская функция фильтрации, свойство filterStyles можно проанализировать в этой функции.

Совокупность свойств и соответствующих значений, которые должны быть связаны с целевым объектом воспроизводимого эффекта.

При работе с эффектами данных это свойство можно использовать для фильтрации эффектов. Если требуется воспроизвести эффект данных для всех целевых объектов из элемента управления list, не добавляемых эффектом, т. е. целевых объектов, удаляемых, замещаемых, перемещаемых или обрабатываемых любым другим способом, можно создать описание эффекта следующим образом:

      <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 использует один из двух типов фильтра, но не оба.

Параметры