DropShadowFilter

包	spark.filters
类	public class DropShadowFilter
继承	DropShadowFilter BaseDimensionFilter BaseFilter EventDispatcher Object
实现	IBitmapFilter

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

可使用 DropShadowFilter 类向显示对象添加投影。阴影算法基于模糊滤镜使用的同一个框型滤镜。投影样式有多个选项，包括内侧或外侧阴影和挖空模式。您可以将滤镜应用于任何显示对象（即，从 DisplayObject 类继承的对象），例如 MovieClip、SimpleButton、TextField 和 Video 对象，以及 BitmapData 对象。

滤镜的具体使用取决于要应用滤镜的对象：

要对显示对象应用滤镜，请使用 filters 属性（继承自 DisplayObject）。设置对象的 filters 属性不会修改相应的对象，而清除 filters 属性可以删除相应的滤镜。
要对 BitmapData 对象应用滤镜，请使用 BitmapData.applyFilter() 方法。对 BitmapData 对象调用 applyFilter() 会取得源 BitmapData 对象和滤镜对象，并最终生成一个过滤图像。

如果对显示对象应用滤镜，则该显示对象的 cacheAsBitmap 属性值将设置为 true。如果清除所有滤镜，将恢复 cacheAsBitmap 的原始值。

此滤镜支持舞台缩放。但是，它不支持常规缩放、旋转和倾斜。如果对象本身进行了缩放（如果将 scaleX 和 scaleY 设置为除 1.0 以外的其它值），滤镜将不进行缩放。只有用户在舞台上进行放大时它才会缩放。

如果所得图像超过最大尺寸，则不应用滤镜。在 AIR 1.5 和 Flash Player 10 中，最大宽度或高度为 8,191 像素，并且像素总数不能超过 16,777,215 像素。（因此，如果图像的宽度为 8,191 像素，则其高度只能为 2,048 像素。）例如，如果在放大某大型影片剪辑时应用了滤镜，则所得图像超过最大尺寸时，将关闭该滤镜。

MXML 语法

隐藏 MXML 语法

The <s:DropShadowFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:DropShadowFilter 
    Properties
    alpha="1"
    angle="45"
    color="0xFF0000"
    distance="4"
    hideObject="false"
    inner="false"
  />

查看示例

相关 API 元素

flash.filters.DropShadowFilter

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		alpha : Number 颜色的 Alpha 透明度值。	DropShadowFilter
		angle : Number 斜角的角度。	DropShadowFilter
		blurX : Number 水平模糊量。	BaseDimensionFilter
		blurY : Number 垂直模糊量。	BaseDimensionFilter
		color : uint 光晕颜色。	DropShadowFilter
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		distance : Number 斜角的偏移距离。	DropShadowFilter
		hideObject : Boolean 表示是否隐藏对象。	DropShadowFilter
		inner : Boolean 指定发光是否为内侧发光。	DropShadowFilter
		knockout : Boolean 指定对象是否具有挖空效果。	BaseDimensionFilter
		quality : int 应用滤镜的次数。	BaseDimensionFilter
		strength : Number 印记或跨页的强度。	BaseDimensionFilter

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false) 构造函数。	DropShadowFilter
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		clone():BitmapFilter 返回此滤镜对象的副本。	DropShadowFilter
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		notifyFilterChanged():void 过滤器更改后传播更改事件。	BaseFilter
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	事件		摘要	由以下参数定义
		activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
		deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义

属性详细信息

alpha

属性

alpha:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

颜色的 Alpha 透明度值。有效值为 0 到 1。例如，0.25 设置透明度值为 25%。

默认值为 1。

实现
public function get alpha():Number
public function set alpha(value:Number):void

angle

属性

angle:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

斜角的角度。有效值为 0 到 360 度。角度值表示理论上的光源落在对象上的角度，它决定了效果相对于该对象的位置。如果 distance 属性设置为 0，则效果相对于对象没有偏移，因此 angle 属性不起作用。

默认值为 45。

实现
public function get angle():Number
public function set angle(value:Number):void

color

属性

color:uint

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

光晕颜色。有效值采用十六进制格式 0xRRGGBB。

默认值为 0xFF0000。

实现
public function get color():uint
public function set color(value:uint):void

distance

属性

distance:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

斜角的偏移距离。有效值以像素为单位（浮点）。

默认值为 4。

实现
public function get distance():Number
public function set distance(value:Number):void

hideObject

属性

hideObject:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

表示是否隐藏对象。如果值为 true，则表示没有绘制对象本身，只有阴影是可见的。默认值为 false，这意味着会显示对象。

默认值为 false。

实现
public function get hideObject():Boolean
public function set hideObject(value:Boolean):void

inner

属性

inner:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

指定发光是否为内侧发光。值 true 表示内侧发光。默认值为 false，即创建外侧发光（对象外缘周围的发光）。

默认值为 false。

实现
public function get inner():Boolean
public function set inner(value:Boolean):void

构造函数详细信息

()

构造函数

public function DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

参数

	`distance:Number` (default = `4.0`) — 阴影的偏移距离，以像素为单位。

	`angle:Number` (default = `45`) — 阴影的角度，0 到 360 度（浮点）。

	`color:uint` (default = `0`) — 阴影颜色，采用十六进制格式 0xRRGGBB。默认值为 0x000000。

	`alpha:Number` (default = `1.0`) — 阴影颜色的 Alpha 透明度值。有效值为 0.0 到 1.0。例如，0.25 设置透明度值为 25%。

	`blurX:Number` (default = `4.0`) — 水平模糊量。有效值为 0 到 255.0（浮点）。

	`blurY:Number` (default = `4.0`) — 垂直模糊量。有效值为 0 到 255.0（浮点）。

	`strength:Number` (default = `1.0`) — 印记或跨页的强度。该值越高，压印的颜色越深，而且阴影与背景之间的对比度也越强。有效值为 0 到 255.0。

	`quality:int` (default = `1`) — 应用滤镜的次数。使用 BitmapFilterQuality 常量： `BitmapFilterQuality.LOW` `BitmapFilterQuality.MEDIUM` `BitmapFilterQuality.HIGH` 有关这些值的详细信息，请参阅 `quality` 属性说明。

	`inner:Boolean` (default = `false`) — 表示阴影是否为内侧阴影。值 `true` 指定内侧阴影。值 `false` 指定外侧阴影（对象外缘周围的阴影）。

	`knockout:Boolean` (default = `false`) — 应用挖空效果 (`true`)，这将有效地使对象的填色变为透明，并显示文档的背景颜色。

	`hideObject:Boolean` (default = `false`) — 表示是否隐藏对象。如果值为 `true`，则表示没有绘制对象本身，只有阴影是可见的。

clone

()

方法

public function clone():BitmapFilter

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

返回此滤镜对象的副本。

BitmapFilter — 具有原始 DropShadowFilter 实例的所有属性的新 DropShadowFilter 实例。

示例如何使用本示例

DropShadowFilterExample.mxml

<?xml version="1.0"?>
<!-- filters/examples/DropShadowFilterExample.mxml -->
<s:Application 
    xmlns:fx="http://ns.adobe.com/mxml/2009" 
    xmlns:mx="library://ns.adobe.com/flex/mx" 
    xmlns:s="library://ns.adobe.com/flex/spark" 
    creationComplete="createFilters()">
    
  <fx:Script><![CDATA[ 
     import spark.filters.*;
     import flash.filters.BitmapFilterQuality;
     import flash.filters.BitmapFilterType;
  
     private var myDropShadowFilter:DropShadowFilter;  
     private var color:Number = 0xFF33FF;
  
     public function createFilters():void {        
        myDropShadowFilter = new DropShadowFilter(15, 45, 
            color, 0.8, 8, 8, 0.65, BitmapFilterQuality.MEDIUM, false, false);
        b1.filters = [myDropShadowFilter];
     }
  
  ]]></fx:Script>

    <s:VGroup>
        <!-- This button has a filter applied in ActionScript. -->
        <s:Button id="b1" label="Click me"/>
        
        <!-- This button has a filter applied in MXML. -->
        <s:Button id="b2" label="Click me">
            <s:filters>
                <s:DropShadowFilter 
                    distance="15" 
                    angle="45" 
                    color="0xFF33FF" 
                    alpha=".8" 
                    blurX="8" 
                    blurY="8" 
                    strength=".65" 
                    quality="{BitmapFilterQuality.MEDIUM}"
                    inner="false" 
                    knockout="false"/>
            </s:filters>
        </s:Button>
        
    </s:VGroup>        
</s:Application>

法律声明 | 在线隐私策略

DropShadowFilter - AS3 Flex

类 x

alpha

angle

color

distance

hideObject

inner

DropShadowFilter

clone