Effect 类的所有子类都必须在其构造函数中设置此属性。

大多数情况下，建议将此属性设置为 true，因为这可以提高应用程序的性能。但是，如果符合下列条件之一，则应将此属性设置为 false：

• 播放效果时可能会出现用户输入内容，并且应用程序必须在效果完成播放前响应用户输入。
• 播放效果时可能会收到来自服务器的响应，并且应用程序必须一面播放效果，一面处理此响应。

自定义遮罩函数具有以下签名：

      public function createLargeMask(targ:Object, bounds:Rectangle):Shape
      {
          var myMask:Shape = new FlexShape();
     
          // Create mask.
     
          return myMask;
      }
      

自定义遮罩函数的一个参数对应于效果的目标组件，另一个参数用于定义目标尺寸，以便您正确设置遮罩大小。您可以使用此参数访问目标组件的 width 和 height 等属性，以创建大小合适的遮罩。

此函数将返回一个用于定义遮罩的 Shape 对象。

要指定此属性，您必须指定以下所有四个属性：scaleXFrom、scaleYFrom、scaleXTo 和 scaleX。

要指定此属性，您必须指定以下所有四个属性：scaleXFrom、scaleYFrom、scaleXTo 和 scaleX。

要指定此属性，您必须指定以下所有四个属性：scaleXFrom、scaleYFrom、scaleXTo 和 scaleX。

要指定此属性，您必须指定以下所有四个属性：scaleXFrom、scaleYFrom、scaleXTo 和 scaleX。

要指定此属性，您必须指定以下所有四个属性：xFrom、yFrom、xTo 和 yTo。

要指定此属性，您必须指定以下所有四个属性：xFrom、yFrom、xTo 和 yTo。

要指定此属性，您必须指定以下所有四个属性：xFrom、yFrom、xTo 和 yTo。

要指定此属性，您必须指定以下所有四个属性：xFrom、yFrom、xTo 和 yTo。

duration 属性的优先级高于此属性的优先级。如果效果的持续时间短于播放一次声音所需的时间，则声音将不循环。

如果未指定缓动函数，则使用基于 Math.sin() 方法的缓动函数。

该缓动函数位于 Robert Penner 编写的函数签名之后。该函数使用四个参数：第一个参数是“current time”，其中动画的开始时间是 0；第二个参数是动画开始时的初始值（一个 Number）；第三个参数是结束值与初始值之间的差值；第四个参数是动画的持续时间。返回值是当前时间的插值。此值通常介于初始值和结束值之间。

此属性的值必须是一个函数对象。

Flex 在 mx.effects.easing 包中提供了一组缓动函数。

如果未指定缓动函数，则使用基于 Math.sin() 方法的缓动函数。

该缓动函数位于 Robert Penner 编写的函数签名之后。该函数使用四个参数：第一个参数是“current time”，其中动画的开始时间是 0；第二个参数是动画开始时的初始值（一个 Number）。第三个参数是结束值与初始值之间的差值；第四个参数是动画的持续时间。返回值是当前时间的内插值（通常是介于初始值和结束值之间的值）。

Flex 在 mx.effects.easing 包中提供了一组缓动函数。

例如，可使用 rollOverEffect 触发 Zoom 效果来缩小目标。目标收缩后，鼠标指针将不再位于目标上方，随之触发 rollOut 事件和相应的 rollOutEffect。通过将 captureRollEvents 属性设置为 true，可以防止 Flex 分派 rollOut 事件，除非因移动鼠标发生此事件。

此值必须介于 0 和目标组件的宽度之间。

此值必须介于 0 和目标组件的高度之间。

如果效果导致目标组件消失，则默认值为目标的 alpha 属性的当前值。如果效果导致目标组件显示，则默认值为 0.0。

如果效果导致目标组件消失，则默认值为 0.0。如果效果导致目标组件显示，则默认值为目标的 alpha 属性的当前值。

这是一个短类名称或 unqualified 类名称，不包含包名称。如果需要限定名称，可使用 flash.utils 包中的 getQualifiedClassName() 方法。

只有在播放效果之前调用 captureStartValues() 方法时，才执行目标过滤。Flex 会在转移效果过程中自动调用 captureStartValues() 方法。

使用 filter 属性可实现简单过滤。如果 customFilter 属性值非空，则会忽略 filter 属性。

在 Parallel 或 Sequence 效果中，可通过 duration 属性设置每种效果的持续时间。例如，如果 Sequence 效果的 duration 属性设置为 3000，则 Sequence 中的每个效果都会播放 3000 毫秒。

对于重复播放的效果来说，duration 属性将指定效果各个实例的持续时间。因此，如果某个效果的 duration 属性设置为 2000，并且 repeatCount 属性设置为 3，则播放此效果共需要 6000 毫秒（6 秒）。

只有在播放效果之前调用 captureStartValues() 方法时，才执行目标过滤。当转移过程或基于列表的控件的数据效果中需使用该效果时，Flex 会自动调用 captureStartValues() 方法。

使用此属性可实现简单过滤。使用 customFilter 属性可实现更为复杂的过滤。如果 customFilter 属性值非空，则会忽略此属性。

filter 属性可使用以下值：

• 如果将此值设置为 "add"，则可以在作为子项添加到容器的任何目标上播放效果。
• 如果将此值设置为 "addItem"，则可以在添加到 List 或 TileList 控件的任何列表项的项呈示器上播放效果。
• 如果将此值设置为 "hide"，则可以在已将 visible 属性从 true 更改为 false 的任何目标上播放效果。
• 如果将此值设置为 "move"，则可以在更改了 x 或 y 属性的任何目标上播放效果。
• 如果将此值设置为 "remove"，则可以在已作为容器子项删除的任何目标上播放效果。
• 如果将此值设置为 "removeItem"，则可以在从 List 或 TileList 控件中删除的任何列表项的项呈示器上播放效果。
• 如果将此值设置为 "replacedItem"，则可以在 List 或 TileList 控件中被替换为新项目的任何列表项的项呈示器上播放效果。
• 如果将此值设置为 "replacementItem"，则可以在添加到 List 或 TileList 控件中用以替换现有项目的任何列表项的项呈示器上播放效果。
• 如果将此值设置为 "resize"，则可以在更改了 width 或 height 属性的任何目标上播放效果。
• 如果将此值设置为 "show"，则可以在已将 visible 属性从 false 更改为 true 的任何目标上播放效果。
• 如果将此值设置为 ""，则指定不进行任何过滤。

将此属性设置为 true 可在播放效果期间隐藏对焦环。

对于 Effect 的子类，默认值是 false。对于 MaskEffect 的子类，默认值是 true。

默认值为 getAffectedProperties() 方法返回的 Array。

默认值为 getAffectedProperties() 方法返回的 Array。

对 eventName 的侦听也与 duration 属性相关，该属性充当该事件的超时。如果未在由 duration 指定的时间段内收到该事件，则该效果无论如何都将结束。

此属性是可选的；默认操作是播放而不等待任何事件。

如果创建此类的子类来创建自定义效果，则必须覆盖此方法并返回包含子类修改的样式属性列表的 Array。

如果 angleTo 的值比 angleFrom 的值小，则目标沿逆时针方向旋转。否则，它将以顺时针方向旋转。如果希望对目标进行多次旋转，请将此值设置为较大的正数或较小的负数。

滤镜函数具有以下特征：

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

其中：

propChanges — PropertyChanges 对象的 Array，每个目标效果组件一个对象。如果过渡未修改目标的属性，则该属性不包括在此 Array 中。

instanceTarget — 要过滤的效果的特定目标组件。在自定义滤镜函数中，首先通过将 instanceTarget 参数比作 propChanges.target 属性来搜索 propChanges Array 以获得与 instanceTarget 参数相匹配的 PropertyChanges 对象。

如果定义自定义滤镜函数，则您可以在自己的函数中检查 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。

如果效果导致目标组件消失，则默认值为目标的 alpha 属性的当前值。如果效果导致目标组件显示，则默认值为 0.0。

如果效果导致目标组件消失，则默认值为 0.0。如果效果导致目标组件显示，则默认值为目标的 alpha 属性的当前值。

这是一个短类名称或“非限定”类名称，不包含包名称。如果需要限定名称，可使用 flash.utils 包中的 getQualifiedClassName() 方法。

将此属性设置为 true 可在播放效果期间隐藏对焦环。

对于 Effect 的子类，默认值是 false。对于 MaskEffect 的子类，默认值是 true。

通常使用 propertyChanges 属性创建转移过程中使用的效果。Flex 会在开始转移时自动调用 captureStartValues() 方法。在覆盖 Effectinstance.play() 方法的过程中，您可以检查 propertyChanges() 方法中的信息，以初始化效果的起始值和结束值。

如果通过调用 play() 方法以编程方式播放（而非由某个事件触发）该效果，则此属性将为 null。