Пакет | 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 |
motionPaths
.
Синтаксис MXMLСкрыть синтаксис MXMLThe <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
Свойство | Определено | ||
---|---|---|---|
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 |
Метод | Определено | ||
---|---|---|---|
Конструктор. | Animate | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | ||
Обеспечивает сбор текущих значений соответствующих свойств целевых объектов эффекта и сохраняет их как конечные значения. | Effect | ||
Обеспечивает сбор текущих значений соответствующих свойств дополнительного набора целевых объектов. Flex использует эту функцию при воспроизведении эффекта изменения данных.
| Effect | ||
Обеспечивает сбор текущих значений соответствующих свойств для целевых объектов эффекта. | Effect | ||
Создает отдельный экземпляр эффекта и инициализирует его. | Effect | ||
Принимает массив целевых объектов и вызывает метод createInstance() для каждой цели. | Effect | ||
Удаляет прослушиватели событий из экземпляра и удаляет экземпляр из списка экземпляров. | Effect | ||
Посылает событие в поток событий. | EventDispatcher | ||
Прерывает эффект, воспроизводящийся в настоящее время, и осуществляет немедленный переход в конец эффекта. | Effect | ||
Возвращает массив строк, где каждая строка представляет собой имя свойства, которое было изменено данным эффектом. | Effect | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Приостанавливает эффект до вызова метода resume(). | Effect | ||
Начинает воспроизведение эффекта | Effect | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | ||
Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause(). | Effect | ||
Если эффект воспроизводится в настоящее время, воспроизводит эффект в обратном порядке, начиная с текущей позиции эффекта. | Effect | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Останавливает эффект, оставляя целевые объекты эффекта в текущем состоянии. | Effect | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher |
Событие | Сводка | Определено | ||
---|---|---|---|---|
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | |||
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | |||
Отправляется в момент завершения воспроизведения экземпляра эффекта, по завершении воспроизведения экземпляра или при прерывании воспроизведения эффекта посредством вызова метода end(). | Effect | |||
Передается для каждого эффекта, повторяемого более одного раза, при его новом повторении. | Animate | |||
Отправляется в момент начала воспроизведения эффекта. | Effect | |||
Отправляется в момент прекращения воспроизведения эффекта, что происходит только в том случае, если воспроизведение эффекта было прервано посредством вызова метода stop(). | Effect | |||
Передается при каждом обновлении целевого объекта эффектом. | 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
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
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
Animate | () | Конструктор |
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 всегда используется для получения доступа к объекту, прослушивающему событие. |
<?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>
Tue Jun 12 2018, 11:34 AM Z