| 包 | mx.effects |
| 类 | public class Glow |
| 继承 | Glow  TweenEffect Effect EventDispatcher Object |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
 | 从 Flex 4.0 开始，Adobe 建议您使用 spark.effects.AnimateFilter 类来替代此类。 在 Flex 4 中，会将 AnimateFilter 效果与 Glow 位图过滤器一起使用。 |
通过 Glow 效果，您可以对组件应用视觉 glow 效果。
Glow 效果将 Flash GlowFilter 类用作其实现的一部分。有关详细信息，请参阅 flash.filters.GlowFilter 类。如果对某个组件应用了 Glow 效果，则无法对该组件应用 GlowFilter，也无法再次应用 Glow 效果。
MXML 语法
显示 MXML 语法
隐藏 MXML 语法The <mx:Glow> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:Glow
id="ID"
alphaFrom="val"
alphaTo="val"
blurXFrom="val"
blurXTo="val"
blurYFrom="val"
blurYTo="val"
color="themeColor of the application"
inner="false|true"
knockout="false|true"
strength="2"
/>
相关 API 元素
公共属性
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| alphaFrom : Number = 1
介于 0.0 和 1.0 之间的初始透明度级别，其中 0.0 表示透明，1.0 表示完全不透明。 | Glow | ||
| alphaTo : Number = 0
介于 0.0 和 1.0 之间的最终透明度级别，其中 0.0 表示透明，1.0 表示完全不透明。 | Glow | ||
| blurXFrom : Number = 5
起始水平模糊量。 | Glow | ||
| blurXTo : Number = 0
终止水平模糊量。 | Glow | ||
| blurYFrom : Number = 5
起始垂直模糊量。 | Glow | ||
| blurYTo : Number = 0
终止垂直模糊量。 | Glow | ||
 | className : String [只读]
效果类的名称，如“Fade”。 | Effect | |
| color : uint = 0xFFFFFFFF
光晕颜色。 | Glow | ||
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| customFilter : mx.effects:EffectTargetFilter
指定一个 EffectTargetFilter 类型的自定义滤镜对象，效果将使用此对象来确定播放效果的目标。 | Effect | |
| duration : Number
效果的持续时间（以毫秒为单位）。 | Effect | |
| easingFunction : Function = null
动画的缓动函数。 | TweenEffect | |
| effectTargetHost : mx.effects:IEffectTargetHost
一个属性，您可以通过设置此属性访问数据效果基于列表的目标控件。 | Effect | |
| filter : String
指定用于过滤效果目标的算法。 | Effect | |
| hideFocusRing : Boolean
确定在开始播放效果时，效果是否应隐藏对焦环。 | Effect | |
| inner : Boolean
指定发光是否为内侧发光。 | Glow | ||
| instanceClass : Class
一个 Class 类型的对象，用于指定此效果类的效果实例类。 | Effect | |
| isPlaying : Boolean [只读]
一个只读标志，如果当前正在播放效果的任一实例，则为 true；否则，则为 false。 | Effect | |
| knockout : Boolean
指定对象是否具有挖空效果。 | Glow | ||
| perElementOffset : Number
在效果的第一个目标之后，其他效果目标的附加延迟（以毫秒为单位）。 | Effect | |
| playheadTime : Number
效果的当前时间位置。 | Effect | |
| relevantProperties : Array
一个属性名称 Array，执行过滤时将使用这些名称。 | Effect | |
| relevantStyles : Array
一个样式名称 Array，执行过滤时将使用这些名称。 | Effect | |
| repeatCount : int = 1
效果的重复次数。 | Effect | |
| repeatDelay : int = 0
重复播放效果前需要等待的时间（以毫秒为单位）。 | Effect | |
| startDelay : int = 0
开始播放效果前需要等待的时间（以毫秒为单位）。 | Effect | |
| strength : Number = 2
印记或跨页的强度。 | Glow | ||
| suspendBackgroundProcessing : Boolean = false
如果为 true，则在播放效果时阻止所有背景处理。 | Effect | |
| target : Object
要应用此效果的对象。 | Effect | |
| targets : Array
一个对象 Array，这些对象都是效果的目标。 | Effect | |
| triggerEvent : Event
如果触发了某个效果，则此项目是由 EffectManager 传递给此 Effect 的 Event 对象；如果 EffectManager 当前没有播放此效果，则为 null。 | Effect | |
受保护的属性
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
构造函数。 | Glow | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
|
捕获效果目标上相关属性的当前值，并将这些值另存为结束值。 | Effect | |
|
捕获另一组目标相关属性的当前值。在运行数据更改效果时，Flex 将使用此函数。
| Effect | |
|
捕获效果目标上相关属性的当前值。 | Effect | |
|
创建一个效果实例并对其进行初始化。 | Effect | |
|
获取一个目标对象 Array，并对每个目标调用 createInstance() 方法。 | Effect | |
|
删除实例中的事件侦听器，然后从实例列表中删除该实例。 | Effect | |
|
将事件调度到事件流中。 | EventDispatcher | |
|
中断当前正在播放的效果，立即跳转到该效果的末尾。 | Effect | |
|
返回一个字符串 Array，其中每个 String 都是被此效果更改的属性的名称。 | Effect | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
暂停效果，直到调用 resume() 方法。 | Effect | |
|
开始播放效果。 | Effect | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
|
在效果由 pause() 方法暂停后继续播放效果。 | Effect | |
|
逆序播放效果；如果当前正在播放效果，则从该效果的当前位置开始逆序播放。 | Effect | |
|
设置循环操作动态属性的可用性。 | Object | |
|
停止播放效果，使效果目标保持当前状态。 | Effect | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回指定对象的字符串表示形式。 | Object | |
|
返回指定对象的原始值。 | Object | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher | |
受保护的方法
属性详细信息
alphaFrom | 属性 |
public var alphaFrom:Number = 1| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
介于 0.0 和 1.0 之间的初始透明度级别，其中 0.0 表示透明，1.0 表示完全不透明。
默认值为 1。
alphaTo | 属性 |
public var alphaTo:Number = 0| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
介于 0.0 和 1.0 之间的最终透明度级别，其中 0.0 表示透明，1.0 表示完全不透明。
默认值为 0。
blurXFrom | 属性 |
public var blurXFrom:Number = 5| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
起始水平模糊量。有效值为 0.0 到 255.0。
默认值为 5。
blurXTo | 属性 |
public var blurXTo:Number = 0| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
终止水平模糊量。有效值为 0.0 到 255.0。
默认值为 0。
blurYFrom | 属性 |
public var blurYFrom:Number = 5| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
起始垂直模糊量。有效值为 0.0 到 255.0。
默认值为 5。
blurYTo | 属性 |
public var blurYTo:Number = 0| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
终止垂直模糊量。有效值为 0.0 到 255.0。
默认值为 0。
color | 属性 |
public var color:uint = 0xFFFFFFFF| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
光晕颜色。默认值为应用程序的 themeColor 样式属性的值。此属性的默认值为 StyleManager.NOT_A_COLOR。对效果调用 play() 时，如果将颜色属性设置为该默认值，则会将效果实例中的颜色值设置为应用程序的当前 themeColor 样式的值。
默认值为 StyleManager.NOT_A_COLOR。
inner | 属性 |
public var inner:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
指定发光是否为内侧发光。值为 true 指示在对象外部边缘的内侧发光。默认值为 false，指示在对象外部边缘的外侧发光。
默认值为 false。
knockout | 属性 |
public var knockout:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
指定对象是否具有挖空效果。值为 true 可使对象的填充颜色透明，以显示基础对象的背景颜色。默认值为 false，指示不应用挖空效果。
默认值为 false。
strength | 属性 |
public var strength:Number = 2| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
印记或跨页的强度。该值越高，压印的颜色越深，而且发光与背景之间的对比度也越强。有效值范围是从 0 到 255。
默认值为 2。
构造函数详细信息
Glow | () | 构造函数 |
示例 如何使用本示例
GlowEffectExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Halo Glow effect. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Declarations>
<mx:Glow id="glowImage" duration="1000"
alphaFrom="1.0" alphaTo="0.3"
blurXFrom="0.0" blurXTo="50.0"
blurYFrom="0.0" blurYTo="50.0"
color="0x00FF00"/>
<mx:Glow id="unglowImage" duration="1000"
alphaFrom="0.3" alphaTo="1.0"
blurXFrom="50.0" blurXTo="0.0"
blurYFrom="50.0" blurYTo="0.0"
color="0x0000FF"/>
</fx:Declarations>
<s:Panel title="Halo Glow Effect Example" width="75%" height="75%" >
<s:VGroup left="20" right="20" top="20" bottom="20">
<s:Label width="100%" color="blue"
text="Click and hold the mouse on the image to see glowImage effect. Release the mouse to see unglowImage effect."/>
<mx:Image source="@Embed(source='assets/Nokia_6630.png')"
mouseDownEffect="{glowImage}"
mouseUpEffect="{unglowImage}"/>
</s:VGroup>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 11:04 AM Z