Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
mx.effects 

Tween  - AS3 Flex

Пакетmx.effects
Классpublic class Tween
НаследованиеTween Inheritance EventDispatcher Inheritance Object

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1


Начиная с Flex 4.0, Adobe рекомендует вместо этого класса использовать класс spark.effects.animation.Animation.

Tween представляет собой базовый класс анимации для эффектов в Flex 3. В Flex 4 для эффектов Spark используется класс spark.effects.animation.Animation, предоставляющий аналогичные функциональные возможности.


Класс Tween определяет анимацию свойства, выполняемую для целевого объекта в течение некоторого интервала времени. К анимации относятся изменение позиции, например выполняемое с помощью эффекта Move; изменение размеров, выполняемое с помощью эффектов Resize или Zoom; изменение видимости, выполняемое с помощью эффектов Fade или Dissolve; и другие типы анимации.

При определении эффектов анимации, как правило, создается экземпляр класса Tween с переопределением метода EffectInstance.play(). Для определения анимации экземпляр Tween принимает свойства startValue, endValue и duration, а также дополнительную функцию замедления.

Объект Tween запускает функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate() в рамках стандартного интервала для экземпляра эффекта во время воспроизведения эффекта и передает методу onTweenUpdate() интерполированное значение в интервале между startValue и endValue. Как правило, функция обратного вызова обновляет некоторые свойства целевого объекта, что приводит к анимации объекта во время всего воспроизведения эффекта.

По завершении эффекта объект Tween запускает функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenEnd(), если она определена.

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



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  duration : Number = 3000
Продолжительность анимации в миллисекундах.
Tween
  easingFunction : Function
[только для записи] Устанавливает функцию замедления для анимации.
Tween
  listener : Object
Объект, получающий уведомление в каждом интервале анимации.
Tween
Общедоступные методы
 МетодОпределено
  
Tween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1, updateFunction:Function = null, endFunction:Function = null)
Конструктор.
Tween
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
Посылает событие в поток событий.
EventDispatcher
  
Прерывают анимацию, переходят непосредственно в конец анимации и запускают функцию обратного вызова onTweenEnd().
Tween
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
Приостанавливает эффект до вызова метода resume().
Tween
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
  
Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause().
Tween
  
Воспроизводит эффект в обратном порядке, начиная с текущей позиции эффекта.
Tween
  
seek(playheadTime:Number):void
Расширяет эффект анимации вплоть до указанной позиции.
Tween
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
setTweenHandlers(updateFunction:Function, endFunction:Function):void
По умолчанию класс Tween запускает функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate() в рамках стандартного интервала для экземпляра эффекта во время воспроизведения эффекта и дополнительную функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenEnd() в конце воспроизведения эффекта.
Tween
  
Останавливает анимацию, заканчивает ее без отправки события или вызова функции анимации endFunction или onTweenEnd().
Tween
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
Сведения о свойстве

duration

свойство
public var duration:Number = 3000

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Продолжительность анимации в миллисекундах.

easingFunction

свойство 
easingFunction:Function  [только для записи]

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Устанавливает функцию замедления для анимации. Функция замедления используется для интерполяции в диапазоне между значениями startValue и endValue. Стандартная функция замедления выполняет линейную интерполяцию, а более сложные функции замедления создают иллюзию ускорения и замедления, придающую анимации естественность.

Если функция замедления не указана, используется функция на основе метода Math.sin().

Функция замедления сопровождается подписью функции, популяризируемой Робертом Пеннером. Функция принимает четыре аргумента. Первый аргумент – «текущее время», где начальное время анимации равно 0. Второй аргумент – начальное значение в начале анимации (число). Третий аргумент – конечное значение минус начальное значение. Четвертый аргумент – продолжительность анимации. Возвращаемое значение – интерполированное значение для текущего времени (как правило, это значение между начальным и конечным значениями).

Flex включает ряд функций замедления, входящих в пакет в mx.effects.easing.



Реализация
    public function set easingFunction(value:Function):void

listener

свойство 
public var listener:Object

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Объект, получающий уведомление в каждом интервале анимации.

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

Tween

()Конструктор
public function Tween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1, updateFunction:Function = null, endFunction:Function = null)

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

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

При вызове конструктора анимация воспроизводится автоматически.

Параметры
listener:Object — Объект, получающий уведомление в каждом интервале анимации. Как правило, в качестве значения передается ключевое слово this. Listener должен определить метод onTweenUpdate() и, при необходимости, метод onTweenEnd(). Первый из двух методов вызывается для каждого интервала анимации, второй метод вызывается только после завершения анимации.
 
startValue:Object — Начальные значения анимации. Число или массив чисел. Если передается число, Tween интерполирует значение в диапазоне между этим числом и числом, переданным параметром endValue. Если передается массив чисел, интерполируется каждое число в массиве.
 
endValue:Object — Последние значения анимации. Тип этого аргумента должен соответствовать параметру startValue.
 
duration:Number (default = -1) — Продолжительность анимации в миллисекундах.
 
minFps:Number (default = -1) — Минимальное количество вызовов метода onTweenUpdate() в секунду. Код Tween выполняет попытки вызова метода onTweenUpdate() настолько часто, насколько это возможно (до 100 раз в секунду). Однако если частота не превосходит minFps, продолжительность анимации автоматически увеличивается. В результате предварительно «замороженная» анимация (не получающая циклов ЦП) не осуществляет немедленный переход вперед, а возобновляется с момента останова.
 
updateFunction:Function (default = null) — Указывает альтернативную функцию обратного вызова для обновления, которая должна использоваться вместо listener.OnTweenUpdate()
 
endFunction:Function (default = null) — Указывает альтернативную функцию обратного вызова для завершения, которая должна использоваться вместо listener.OnTweenEnd()
Сведения о методе

endTween

()метод
public function endTween():void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Прерывают анимацию, переходят непосредственно в конец анимации и запускают функцию обратного вызова onTweenEnd().

pause

()метод 
public function pause():void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Приостанавливает эффект до вызова метода resume().

resume

()метод 
public function resume():void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause().

reverse

()метод 
public function reverse():void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Воспроизводит эффект в обратном порядке, начиная с текущей позиции эффекта.

seek

()метод 
public function seek(playheadTime:Number):void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Расширяет эффект анимации вплоть до указанной позиции.

Параметры

playheadTime:Number — Положение в миллисекундах между 0 и значением свойства duration.

setTweenHandlers

()метод 
public function setTweenHandlers(updateFunction:Function, endFunction:Function):void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

По умолчанию класс Tween запускает функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate() в рамках стандартного интервала для экземпляра эффекта во время воспроизведения эффекта и дополнительную функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenEnd() в конце воспроизведения эффекта.

Этот метод позволяет указывать другие методы в качестве функций обратного вызова для обновления и завершения.

Параметры

updateFunction:Function — Указывает функцию обратного вызова для обновления.
 
endFunction:Function — Указывает функцию обратного вызова для завершения.

stop

()метод 
public function stop():void

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Останавливает анимацию, заканчивает ее без отправки события или вызова функции анимации endFunction или onTweenEnd().





[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.