用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
spark.effects 

Resize  - AS3 Flex

spark.effects
public class Resize
继承Resize Inheritance Animate Inheritance Effect Inheritance EventDispatcher Inheritance Object

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 10, AIR 1.5

Resize 效果在指定的时间间隔更改组件的宽度或高度,或同时更改这两者。

如果您仅指定 widthFromwidthTowidthBy 属性这三个值中的两个值,则 Flex 会计算第三个值。如果指定了所有这三个值,Flex 将忽略 widthBy 值。如果您仅指定 widthBywidthTo 值,则会将 widthFrom 属性设置为对象的当前宽度。对于 heightFromheightToheightBy 属性值,同样如此。

MXML 语法expanded隐藏 MXML 语法

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

  <s:Resize
    id="ID"
    widthFrom="val"
    heightFrom="val"
    widthTo="val"
    heightTo="val"
    widthBy="val"
    heightBy="val"
  />
  

默认 MXML 属性motionPaths

查看示例

相关 API 元素



公共属性
 属性由以下参数定义
 InheritedclassName : String
[只读] 效果类的名称,如“Fade”。
Effect
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcustomFilter : mx.effects:EffectTargetFilter
指定一个 EffectTargetFilter 类型的自定义滤镜对象,效果将使用此对象来确定播放效果的目标。
Effect
 InheriteddisableLayout : Boolean
如果为 true,则效果通过将容器的 autoLayout 属性设置为 false 对其目标的父容器禁用布局,并同时对目标对象禁用任何布局约束。
Animate
 Inheritedduration : Number
效果的持续时间(以毫秒为单位)。
Effect
 Inheritedeaser : IEaser
此效果的缓动行为。
Animate
 InheritedeffectTargetHost : mx.effects:IEffectTargetHost
一个属性,您可以通过设置此属性访问数据效果基于列表的目标控件。
Effect
 Inheritedfilter : String
指定用于过滤效果目标的算法。
Effect
  heightBy : Number
组件高度所修改的像素数目。
Resize
  heightFrom : Number
初始高度(以像素为单位)。
Resize
  heightTo : Number
目标的最终高度(以像素为单位)。
Resize
 InheritedhideFocusRing : Boolean
确定在开始播放效果时,效果是否应隐藏对焦环。
Effect
 InheritedinstanceClass : Class
一个 Class 类型的对象,用于指定此效果类的效果实例类。
Effect
 Inheritedinterpolator : IInterpolator
此效果计算属性的起始值和结束值之间的值所用的插补器。
Animate
 InheritedisPlaying : Boolean
[只读] 一个只读标志,如果当前正在播放效果的任一实例,则为 true;否则,则为 false。
Effect
 InheritedmotionPaths : Vector.<MotionPath>
MotionPath 对象的 Vector,其中的每个对象都带有正在设置动画的属性的名称以及该属性在动画过程中所采用的值。
Animate
 InheritedperElementOffset : Number
在效果的第一个目标之后,其他效果目标的附加延迟(以毫秒为单位)。
Effect
 InheritedplayheadTime : Number
效果的当前时间位置。
Effect
 InheritedrelevantProperties : Array
一个属性名称 Array,执行过滤时将使用这些名称。
Effect
 InheritedrelevantStyles : Array
一个样式名称 Array,执行过滤时将使用这些名称。
Effect
 InheritedrepeatBehavior : String
一种重复效果的行为,这意味着 repeatCount 等于 0 或大于 1 的效果。
Animate
 InheritedrepeatCount : int = 1
效果的重复次数。
Effect
 InheritedrepeatDelay : int = 0
重复播放效果前需要等待的时间(以毫秒为单位)。
Effect
 InheritedstartDelay : int = 0
开始播放效果前需要等待的时间(以毫秒为单位)。
Effect
 Inheritedtarget : Object
要应用此效果的对象。
Effect
 Inheritedtargets : Array
一个对象 Array,这些对象都是效果的目标。
Effect
 InheritedtriggerEvent : Event
如果触发了某个效果,则此项目是由 EffectManager 传递给此 Effect 的 Event 对象;如果 EffectManager 当前没有播放此效果,则为 null。
Effect
  widthBy : Number
按其修改目标的宽度的像素数目。
Resize
  widthFrom : Number
目标的初始宽度(以像素为单位)。
Resize
  widthTo : Number
目标的最终宽度(以像素为单位)。
Resize
受保护的属性
 属性由以下参数定义
 InheritedapplyTransitionEndProperties : Boolean
此标志控制该效果(进行转换时)是否将根据结束状态自动应用属性值,这与将值保留为效果本身所设置的值相反。
Effect
 InheritedendValuesCaptured : Boolean = false
一个标志,如果已确定效果的结束值,则该标志中包含 true;如果需要在效果运行时从效果目标的当前属性捕获这些值,则其中包含 false。
Effect
公共方法
 方法由以下参数定义
  
Resize(target:Object = null)
构造函数。
Resize
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
捕获效果目标上相关属性的当前值,并将这些值另存为结束值。
Effect
 Inherited
捕获另一组目标相关属性的当前值。在运行数据更改效果时,Flex 将使用此函数。
Effect
 Inherited
捕获效果目标上相关属性的当前值。
Effect
 Inherited
创建一个效果实例并对其进行初始化。
Effect
 Inherited
createInstances(targets:Array = null):Array
获取一个目标对象 Array,并对每个目标调用 createInstance() 方法。
Effect
 Inherited
删除实例中的事件侦听器,然后从实例列表中删除该实例。
Effect
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
end(effectInstance:IEffectInstance = null):void
中断当前正在播放的效果,立即跳转到该效果的末尾。
Effect
 Inherited
返回一个字符串 Array,其中每个 String 都是被此效果更改的属性的名称。
Effect
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
暂停效果,直到调用 resume() 方法。
Effect
 Inherited
play(targets:Array = null, playReversedFromEnd:Boolean = false):Array
开始播放效果。
Effect
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
在效果由 pause() 方法暂停后继续播放效果。
Effect
 Inherited
逆序播放效果;如果当前正在播放效果,则从该效果的当前位置开始逆序播放。
Effect
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
停止播放效果,使效果目标保持当前状态。
Effect
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。
EventDispatcher
受保护的方法
 方法由以下参数定义
 Inherited
applyValueToTarget(target:Object, property:String, value:*, props:Object):void
供 Effect 基础结构内部使用。
Effect
 Inherited
当效果实例完成播放时调用。
Effect
 Inherited
当效果实例开始播放时调用此方法。
Effect
 Inherited
当效果实例已被 stop() 方法调用停止时调用。
Effect
 Inherited
filterInstance(propChanges:Array, target:Object):Boolean
确定筛选效果实例所用的逻辑。
Effect
 Inherited
getValueFromTarget(target:Object, property:String):*
由 captureStartValues() 方法调用,用来从目标获得某个属性的值。
Effect
 Inherited
将效果的属性复制到效果实例。
Effect
事件
 事件 摘要 由以下参数定义
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
 Inherited在其中一个效果实例完成播放时(既可以是实例实际完成播放时,也可以是通过调用 end() 方法中断效果时)调度。Effect
 Inherited对于任何重复次数超过一次的效果,当效果开始新的重复时调度。Animate
 Inherited当效果开始播放时调度。Effect
 Inherited在已停止效果时调度,仅当该效果已被 stop() 方法调用中断时才会发生。Effect
 Inherited每当效果更新目标时调度。Animate
属性详细信息

heightBy

属性
public var heightBy:Number

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 10, AIR 1.5

组件高度所修改的像素数目。值可以为负数。

heightFrom

属性 
public var heightFrom:Number

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 10, AIR 1.5

初始高度(以像素为单位)。如果将其忽略,Flex 会使用目标的当前高度。

heightTo

属性 
public var heightTo:Number

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 10, AIR 1.5

目标的最终高度(以像素为单位)。

widthBy

属性 
public var widthBy:Number

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 10, AIR 1.5

按其修改目标的宽度的像素数目。值可以为负数。

widthFrom

属性 
public var widthFrom:Number

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 10, AIR 1.5

目标的初始宽度(以像素为单位)。如果省略,Flex 将使用当前宽度。

widthTo

属性 
public var widthTo:Number

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 10, AIR 1.5

目标的最终宽度(以像素为单位)。

构造函数详细信息

Resize

()构造函数
public function Resize(target:Object = null)

语言版本: ActionScript 3.0
产品版本: Flex 4
运行时版本: Flash Player 10, AIR 1.5

构造函数。

参数
target:Object (default = null) — 要使用此效果为其设置动画的 Object。
ResizeEffectExample.mxml
<?xml version="1.0"?>
<!-- Simple example to demonstrate the s:Resize class. -->
<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">

    <fx:Declarations>
        <s:Resize id="expandEffect" target="{targetImg}" widthTo="100" heightTo="200"
            repeatCount="2" repeatBehavior="reverse" effectStart="playButton.enabled=false"
            effectEnd="playButton.enabled=true;"/>
    </fx:Declarations>

    <s:Panel title="Resize Effect Example"
        width="75%" height="75%" >

        <mx:HBox width="100%" height="100%">
            <!-- Our target to affect-->
            <mx:VBox id="targetBox" width="50%"  horizontalAlign="center">
                <mx:Label text="Nokia 9930"/>
                <mx:Image id="targetImg" width="30" height="60"
                    source="@Embed(source='assets/Nokia_6630.png')"/>
            </mx:VBox>
            <mx:VBox id="detailsBox" width="50%" left="0">
                <mx:Text width="99%" color="blue"
                    text="The Resize effect changes the size of a target using the following parameters: widthFrom, widthTo, widthBy, heightFrom, heightTo, heightBy. Click 'Resize' to watch the effect."/>
            </mx:VBox>
        </mx:HBox>

        <s:Rect left="0" right="0" bottom="0" height="30">
            <s:fill>
                <s:LinearGradient rotation="90">
                    <s:GradientEntry color="0xE2E2E2" />
                    <s:GradientEntry color="0xD9D9D9" />
                </s:LinearGradient>
            </s:fill>
        </s:Rect>
        <s:Button id="playButton"
            left="5" bottom="5"
            label="Resize" click="expandEffect.play();"/>
    </s:Panel>
</s:Application>




[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。