Animate

Пакет	spark.effects
Класс	public class Animate
Наследование	Animate Effect EventDispatcher Object
Подклассы	AnimateColor, AnimateFilter, AnimateTransform, AnimateTransitionShader, Fade, Resize

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Эффект Animate анимирует произвольный набор свойств между значениями. Для анимации необходимо указать свойства и значения, установив свойство motionPaths.

Синтаксис MXML expanded

Скрыть синтаксис MXML

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

  <s:Animate
    Properties
    id="ID"
    disableLayout="false"
    easer="{spark.effects.easing.Sine(.5)}"
    interpolator="NumberInterpolator"
    motionPaths="no default"
    repeatBehavior="loop"
  />

Свойство MXML по умолчаниюmotionPaths

Посмотреть примеры

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

spark.effects.supportClasses.AnimateInstance

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		className : String [только для чтения] Имя класса эффекта, например Fade.	Effect
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		customFilter : mx.effects:EffectTargetFilter Указывает пользовательский объект фильтра типа EffectTargetFilter, используемый эффектом для определения целевых объектов, для которых должен воспроизводиться эффект.	Effect
		disableLayout : Boolean Если значение равно true, эффект отключает макет на вышестоящих контейнерах его целевых объектов, устанавливая для свойства autoLayout контейнеров значение false, а также отключает любые ограничения макета на целевые объекты.	Animate
		duration : Number Продолжительность эффекта в миллисекундах.	Effect
		easer : IEaser Реакция замедления для этого эффекта.	Animate
		effectTargetHost : mx.effects:IEffectTargetHost Свойства, позволяющие получить доступ к целевому элементу управления на основе списка для эффекта данных.	Effect
		filter : String Указывает алгоритм фильтрации целевых объектов для эффекта.	Effect
		hideFocusRing : Boolean Определяет, должен ли эффект скрыть кольцо фокуса при запуске.	Effect
		instanceClass : Class Объект типа Class, указывающий класс класса экземпляра эффекта для данного класса эффекта.	Effect
		interpolator : IInterpolator Для вычисления значений между начальными и конечными значениями свойства данным эффектом используется интерполятор.	Animate
		isPlaying : Boolean [только для чтения] Флаг только для чтения, принимающий значение true, если какой-либо экземпляр эффекта воспроизводится в настоящее время, и false в противном случае.	Effect
		motionPaths : Vector.<MotionPath> Вектор объектов MotionPath, каждый из которых содержит имя подлежащего анимации свойства и значения, которые данное свойство принимает в процессе анимации.	Animate
		perElementOffset : Number Дополнительная задержка (в миллисекундах) для целевых объектов эффекта, обрабатываемых после первого целевого объекта эффекта.	Effect
		playheadTime : Number Текущая позиция эффекта.	Effect
		relevantProperties : Array Массив имен свойств, используемых при выполнении фильтрации.	Effect
		relevantStyles : Array Массив имен стилей, используемых при выполнении фильтрации.	Effect
		repeatBehavior : String Поведение повторяющегося эффекта, то есть эффекта со значением repeatCount, равным 0 или > 1.	Animate
		repeatCount : int = 1 Число повторов эффекта.	Effect
		repeatDelay : int = 0 Время ожидания (в миллисекундах) перед повторением эффекта.	Effect
		startDelay : int = 0 Время ожидания (в миллисекундах) перед запуском эффекта.	Effect
		target : Object Объект, к которому применяется данный эффект.	Effect
		targets : Array Массив объектов, являющихся целевыми объектами эффекта.	Effect
		triggerEvent : Event Объект Event, переданный в Effect с помощью EffectManager при запуске эффекта, или null, если эффект воспроизводится без EffectManager.	Effect

Защищенные свойства

Скрыть унаследованные защищенные свойства

Показать унаследованные защищенные свойства

	Свойство		Определено
		applyTransitionEndProperties : Boolean Этот флаг указывает, должен ли эффект, воспроизводящийся при переходе, автоматически применить значения свойств, соответствующие конечному состоянию, или сохранить значения, установленные самим эффектом.	Effect
		endValuesCaptured : Boolean = false Флаг, содержащий значение true, если конечные значения эффекта уже определены, или значение false, если они должны быть получены из текущих свойств целевых объектов эффекта при воспроизведении эффекта.	Effect

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		Animate(target:Object = null) Конструктор.	Animate
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		captureEndValues():void Обеспечивает сбор текущих значений соответствующих свойств целевых объектов эффекта и сохраняет их как конечные значения.	Effect
		captureMoreStartValues(targets:Array):void Обеспечивает сбор текущих значений соответствующих свойств дополнительного набора целевых объектов. Flex использует эту функцию при воспроизведении эффекта изменения данных.	Effect
		captureStartValues():void Обеспечивает сбор текущих значений соответствующих свойств для целевых объектов эффекта.	Effect
		createInstance(target:Object = null):IEffectInstance Создает отдельный экземпляр эффекта и инициализирует его.	Effect
		createInstances(targets:Array = null):Array Принимает массив целевых объектов и вызывает метод createInstance() для каждой цели.	Effect
		deleteInstance(instance:IEffectInstance):void Удаляет прослушиватели событий из экземпляра и удаляет экземпляр из списка экземпляров.	Effect
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		end(effectInstance:IEffectInstance = null):void Прерывает эффект, воспроизводящийся в настоящее время, и осуществляет немедленный переход в конец эффекта.	Effect
		getAffectedProperties():Array Возвращает массив строк, где каждая строка представляет собой имя свойства, которое было изменено данным эффектом.	Effect
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		pause():void Приостанавливает эффект до вызова метода resume().	Effect
		play(targets:Array = null, playReversedFromEnd:Boolean = false):Array Начинает воспроизведение эффекта	Effect
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		resume():void Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause().	Effect
		reverse():void Если эффект воспроизводится в настоящее время, воспроизводит эффект в обратном порядке, начиная с текущей позиции эффекта.	Effect
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		stop():void Останавливает эффект, оставляя целевые объекты эффекта в текущем состоянии.	Effect
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

Защищенные методы

Скрыть унаследованные защищенные методы

Показать унаследованные защищенные методы

	Метод		Определено
		applyValueToTarget(target:Object, property:String, value:*, props:Object):void Используется внутренне инфраструктурой Effect.	Effect
		effectEndHandler(event:EffectEvent):void Вызывается по завершении воспроизведения экземпляра эффекта.	Effect
		effectStartHandler(event:EffectEvent):void Этот метод вызывается в момент начала воспроизведения эффекта.	Effect
		effectStopHandler(event:EffectEvent):void Вызывается при остановке воспроизведения экземпляра эффекта посредством вызова метода stop().	Effect
		filterInstance(propChanges:Array, target:Object):Boolean Определяет логику фильтрации экземпляра эффекта.	Effect
		getValueFromTarget(target:Object, property:String):* Вызывается методом captureStartValues() для получения значения свойства целевого объекта.	Effect
		initInstance(instance:IEffectInstance):void Свойства копий эффекта для экземпляра эффекта.	Effect

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
effectEnd	Отправляется в момент завершения воспроизведения экземпляра эффекта, по завершении воспроизведения экземпляра или при прерывании воспроизведения эффекта посредством вызова метода end().	Effect
effectRepeat	Передается для каждого эффекта, повторяемого более одного раза, при его новом повторении.	Animate
effectStart	Отправляется в момент начала воспроизведения эффекта.	Effect
effectStop	Отправляется в момент прекращения воспроизведения эффекта, что происходит только в том случае, если воспроизведение эффекта было прервано посредством вызова метода stop().	Effect
effectUpdate	Передается при каждом обновлении целевого объекта эффектом.	Animate

Сведения о свойстве

disableLayout

свойство

disableLayout:Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

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

Значением по умолчанию является false.

Реализация
public function get disableLayout():Boolean
public function set disableLayout(value:Boolean):void

easer

свойство

easer:IEaser

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Реакция замедления для этого эффекта. Этот объект IEaser используется для преобразования доли времени, потребовавшегося на анимацию, в долю времени, затраченного на замедление, которая затем используется для расчета значений по этой доле затраченного на замедление времени.

Следует отметить, что возможно замедление на уровне эффекта и на уровне ключевого кадра (где ключевые кадры удерживают значение/время, используемые в структурах MotionPath). Эти реакции замедления будут основываться друг на друге. easer управляет замедлением всего эффекта. Ключевой кадр управляет замедлением в одном отдельном интервале анимации. По умолчанию замедление для анимации является нелинейным (Sine(0,5)), в то время как замедление для ключевых кадров линейно. При необходимости получения эффекта с замедлением на уровне ключевого кадра вы можете установить линейное замедление эффекта, а затем установить замедление отдельно на ключевые кадры.

Значением по умолчанию является spark.effects.easing.Sine(.5).

Реализация
public function get easer():IEaser
public function set easer(value:IEaser):void

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

spark.effects.easing.Sine

interpolator

свойство

interpolator:IInterpolator

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Для вычисления значений между начальными и конечными значениями свойства данным эффектом используется интерполятор. По умолчанию интерполяцию обрабатывает класс NumberInterpolator или, если начальные и конечные значения являются массивами или векторами, класс MultiValueInterpolator. Интерполяция других типов или таких чисел, которые должны быть интерполированы иначе (например, значения uint, содержащие информацию о цветовых каналах), может быть обработана при помощи других интерполяторов.

Реализация
public function get interpolator():IInterpolator
public function set interpolator(value:IInterpolator):void

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

spark.effects.interpolation.NumberInterpolator
spark.effects.interpolation.MultiValueInterpolator

motionPaths

свойство

motionPaths:Vector.<MotionPath>

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Вектор объектов MotionPath, каждый из которых содержит имя подлежащего анимации свойства и значения, которые данное свойство принимает в процессе анимации. Данный вектор имеет приоритет над любыми свойствами, объявленным в подклассах Animate. Например, если данный массив установлен непосредственно на эффект Move, то любые свойства эффекта Move (например, xFrom) будут игнорироваться.

Реализация
public function get motionPaths():Vector.<MotionPath>
public function set motionPaths(value:Vector.<MotionPath>):void

repeatBehavior

свойство

repeatBehavior:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Поведение повторяющегося эффекта, то есть эффекта со значением repeatCount равным 0 или > 1. Этим значением может являться либо RepeatBehavior.LOOP, что означает повторение анимации в одном и том же порядке каждый раз, либо RepeatBehavior.REVERSE, что означает смену направления анимации при каждой итерации.

Значением по умолчанию является RepeatBehavior.LOOP.

Реализация
public function get repeatBehavior():String
public function set repeatBehavior(value:String):void

Сведения о конструкторе

()

Конструктор

public function Animate(target:Object = null)

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Конструктор.

Параметры

target:Object (default = null) — Объект, анимируемый с использованием данного эффекта.

Сведения о событии

effectRepeat

Событие

Тип объекта события: mx.events.EffectEvent
свойство EffectEvent.type = mx.events.EffectEvent.EFFECT_REPEAT

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Передается для каждого эффекта, повторяемого более одного раза, при его новом повторении. Flex также передает для данного эффекта событие effectUpdate.

Константа EffectEvent.EFFECT_REPEAT определяет значение свойства type объекта события для события effectRepeat.

Свойства объекта события имеют следующие значения:

Свойство	Значение
`bubbles`	false
`cancelable`	false
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется `myButton.addEventListener()` для регистрации прослушивателя события, значением `currentTarget` является myButton.
`effectInstance`	Объект экземпляра эффекта для события.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.

effectUpdate

Событие

Тип объекта события: mx.events.EffectEvent
свойство EffectEvent.type = mx.events.EffectEvent.EFFECT_UPDATE

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Передается при каждом обновлении целевого объекта эффектом.

Константа EffectEvent.EFFECT_UPDATE определяет значение свойства type объекта события для события effectUpdate.

Свойства объекта события имеют следующие значения:

Свойство	Значение
`bubbles`	false
`cancelable`	false
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется `myButton.addEventListener()` для регистрации прослушивателя события, значением `currentTarget` является myButton.
`effectInstance`	Объект экземпляра эффекта для события.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.

Примеры Использование этого примера

AnimateEffectExample.mxml

<?xml version="1.0"?>
<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:Animate id="animateEffect"
            target="{targetBox}" repeatCount="2" repeatBehavior="reverse" disableLayout="true" effectStart="playButton.enabled=false" effectEnd="playButton.enabled=true;">
            <s:motionPaths>
                <s:SimpleMotionPath property="x" valueFrom="0" valueTo="100"/>
                <s:SimpleMotionPath property="alpha" valueFrom="1" valueTo="0"/>
            </s:motionPaths>
        </s:Animate>
    </fx:Declarations>

    <s:Panel title="Animate 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" 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 Animate effect animates any property or style of an object over time using animationProperty arrays. Click 'Animate' 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="Animate"
            click="animateEffect.play();"/>
    </s:Panel>
</s:Application>

Юридическая информация | Политика конфиденциальности онлайн

Animate - AS3 Flex

Классы x

disableLayout

easer

interpolator

motionPaths

repeatBehavior

Animate

effectRepeat

effectUpdate