Пакет | mx.effects |
Класс | public class TweenEffect |
Наследование | TweenEffect Effect EventDispatcher Object |
Подклассы | AnimateProperty, Blur, Dissolve, Fade, Glow, Move, Pause, Resize, Rotate, SeriesEffect, Zoom |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Начиная с Flex 4.0, Adobe рекомендует вместо этого класса использовать класс spark.effects.Animate. TweenEffect представляет собой суперкласс для анимируемых эффектов в Flex 3. В Flex 4 эффекты Spark расширяют класс spark.effects.Animate вместо TweenEffect. |
Класс TweenEffect является суперклассом для всех эффектов на основе объекта Tween. Этот класс инкапсулирует методы и свойства, общие для всех эффектов на основе объекта Tween, что позволяет избежать дублирования кода.
Для определения эффекта, воспроизводящего анимацию в течение некоторого интервала времени, необходимо создать подкласс класса TweenEffect. Например, эффект Resize изменяет размер целевого объекта в течение указанного интервала.
Синтаксис MXMLСкрыть синтаксис MXMLThe <mx:TweenEffect>
tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:TagName Properties easingFunction="easing function name; no default" Events tweenEnd="No default" />
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
className : String [только для чтения]
Имя класса эффекта, например Fade. | Effect | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
customFilter : mx.effects:EffectTargetFilter
Указывает пользовательский объект фильтра типа EffectTargetFilter, используемый эффектом для определения целевых объектов, для которых должен воспроизводиться эффект. | Effect | ||
duration : Number
Продолжительность эффекта в миллисекундах. | Effect | ||
easingFunction : Function = null
Функция замедления для анимации. | TweenEffect | ||
effectTargetHost : mx.effects:IEffectTargetHost
Свойства, позволяющие получить доступ к целевому элементу управления на основе списка для эффекта данных. | Effect | ||
filter : String
Указывает алгоритм фильтрации целевых объектов для эффекта. | Effect | ||
hideFocusRing : Boolean
Определяет, должен ли эффект скрыть кольцо фокуса при запуске. | Effect | ||
instanceClass : Class
Объект типа Class, указывающий класс класса экземпляра эффекта для данного класса эффекта. | Effect | ||
isPlaying : Boolean [только для чтения]
Флаг только для чтения, принимающий значение true, если какой-либо экземпляр эффекта воспроизводится в настоящее время, и false в противном случае. | Effect | ||
perElementOffset : Number
Дополнительная задержка (в миллисекундах) для целевых объектов эффекта, обрабатываемых после первого целевого объекта эффекта. | Effect | ||
playheadTime : Number
Текущая позиция эффекта. | Effect | ||
relevantProperties : Array
Массив имен свойств, используемых при выполнении фильтрации. | Effect | ||
relevantStyles : Array
Массив имен стилей, используемых при выполнении фильтрации. | Effect | ||
repeatCount : int = 1
Число повторов эффекта. | Effect | ||
repeatDelay : int = 0
Время ожидания (в миллисекундах) перед повторением эффекта. | Effect | ||
startDelay : int = 0
Время ожидания (в миллисекундах) перед запуском эффекта. | Effect | ||
suspendBackgroundProcessing : Boolean = false
Если значение равно true, блокирует всю фоновую обработку во время воспроизведения эффекта. | Effect | ||
target : Object
Объект, к которому применяется данный эффект. | Effect | ||
targets : Array
Массив объектов, являющихся целевыми объектами эффекта. | Effect | ||
triggerEvent : Event
Объект Event, переданный в Effect с помощью EffectManager при запуске эффекта, или null, если эффект воспроизводится без EffectManager. | Effect |
Метод | Определено | ||
---|---|---|---|
TweenEffect(target:Object = null)
Конструктор. | TweenEffect | ||
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 |
Метод | Определено | ||
---|---|---|---|
Используется внутренне инфраструктурой Effect. | Effect | ||
Вызывается по завершении воспроизведения экземпляра эффекта. | Effect | ||
Этот метод вызывается в момент начала воспроизведения эффекта. | Effect | ||
Вызывается при остановке воспроизведения экземпляра эффекта посредством вызова метода stop(). | Effect | ||
Определяет логику фильтрации экземпляра эффекта. | Effect | ||
Вызывается методом captureStartValues() для получения значения свойства целевого объекта. | Effect | ||
Свойства копий эффекта для экземпляра эффекта. | Effect | ||
Вызывается, когда TweenEffect отправляет TweenEvent. | TweenEffect |
Событие | Сводка | Определено | ||
---|---|---|---|---|
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | |||
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | |||
Отправляется в момент завершения воспроизведения экземпляра эффекта, по завершении воспроизведения экземпляра или при прерывании воспроизведения эффекта посредством вызова метода end(). | Effect | |||
Отправляется в момент начала воспроизведения эффекта. | Effect | |||
Отправляется в момент прекращения воспроизведения эффекта, что происходит только в том случае, если воспроизведение эффекта было прервано посредством вызова метода stop(). | Effect | |||
Отправляется по завершении эффекта анимации. | TweenEffect | |||
Отправляется при запуске эффекта анимации, что соответствует первому вызову метода onTweenUpdate(). | TweenEffect | |||
Отправляется при каждом обновлении целевого объекта эффектом анимации. | TweenEffect |
easingFunction | свойство |
public var easingFunction:Function = null
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Функция замедления для анимации. Функция замедления используется для интерполяции значений в диапазоне между начальным и конечным значениями. Стандартная функция замедления выполняет линейную интерполяцию, а более сложные функции замедления создают иллюзию ускорения и замедления, придающую анимации естественность.
Если функция замедления не указана, используется функция на основе метода Math.sin()
.
Функция замедления сопровождается подписью функции, популяризируемой Робертом Пеннером. Функция принимает четыре аргумента. Первый аргумент – «текущее время», где начальное время анимации равно 0. Второй аргумент – начальное значение в начале анимации (число). Третий аргумент – конечное значение минус начальное значение. Четвертый аргумент – продолжительность анимации. Возвращаемое значение – интерполированное значение для текущего времени. Как правило, это значение находится в диапазоне между начальным и конечным значениями.
Значением этого свойства должен быть объект функции.
Flex включает ряд функций замедления, входящих в пакет в mx.effects.easing.
TweenEffect | () | Конструктор |
tweenEventHandler | () | метод |
protected function tweenEventHandler(event:mx.events:TweenEvent):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Вызывается, когда TweenEffect отправляет TweenEvent. В случае переопределения данного метода следует убедиться, что вызывается вышестоящий метод.
Параметры
event:mx.events:TweenEvent — Объект события типа TweenEvent.
|
tweenEnd | Событие |
mx.events.TweenEvent
свойство TweenEvent.type =
mx.events.TweenEvent.TWEEN_END
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отправляется по завершении эффекта анимации. Это событие соответствует вызову метода TweenEffectInstance.onTweenEnd()
.
При однократном воспроизведении эффекта анимации данное событие происходит одновременно с событием effectEnd
. Если эффект анимации является повторяющимся, это событие происходит в конце каждого повторения эффекта, а событие endEffect
происходит после последнего воспроизведения эффекта.
TweenEvent.TWEEN_END
определяет значение свойства type
объекта события tweenEnd
.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
value | Значение, передаваемое в метод onTweenEnd() . |
tweenStart | Событие |
mx.events.TweenEvent
свойство TweenEvent.type =
mx.events.TweenEvent.TWEEN_START
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отправляется при запуске эффекта анимации, что соответствует первому вызову метода onTweenUpdate()
. Одновременно Flex также отправляет первое событие tweenUpdate
для эффекта.
Событие Effect.effectStart
отправляется перед событием tweenStart
.
TweenEvent.TWEEN_START
определяет значение свойства type
объекта события tweenStart
.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
value | Значение, передаваемое в метод onTweenUpdate() . |
tweenUpdate | Событие |
mx.events.TweenEvent
свойство TweenEvent.type =
mx.events.TweenEvent.TWEEN_UPDATE
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отправляется при каждом обновлении целевого объекта эффектом анимации. Это событие соответствует вызову метода TweenEffectInstance.onTweenUpdate()
.
TweenEvent.TWEEN_UPDATE
определяет значение свойства type
объекта события tweenUpdate
.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
value | Значение, передаваемое в метод onTweenUpdate() . |
<?xml version="1.0"?> <!-- Simple example to demonstrate the TweenEffect class. --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx"> <fx:Script> <![CDATA[ import mx.events.TweenEvent; // Event handler for the tweenUpdate and tweenEnd effects. private function tweenUpdateHandler(event:TweenEvent):void { // Access current width of the image. currentWidth.text="Current width (in pixels): " + String(event.value[0]); } // Event handler for the reset button. private function resetHandler():void { expand.end(); img.width=30; currentWidth.text="Current width (in pixels): 30"; img.height=60; button1.enabled=true; } ]]> </fx:Script> <fx:Declarations> <mx:Resize id="expand" target="{img}" widthTo="100" heightTo="200" duration="10000" tweenUpdate="tweenUpdateHandler(event);" tweenEnd="tweenUpdateHandler(event);"/> </fx:Declarations> <s:Panel title="Resize Effect Example" width="100%" height="100%" > <s:VGroup left="20" right="20" top="20" bottom="20"> <s:Label width="100%" color="blue" text="Use the Button controls to resize the image."/> <s:HGroup width="100%"> <mx:Image id="img" width="30" height="60" source="@Embed(source='assets/Nokia_6630.png')"/> <s:Label id="currentWidth" height="20" width="100%"/> </s:HGroup> <s:Button id="button1" label="Start" click="expand.play(); button1.enabled=false;"/> <s:Button label="Pause" click="expand.pause();"/> <s:Button label="Resume" click="expand.resume();"/> <s:Button label="Reverse" click="expand.reverse();"/> <s:Button label="End" click="expand.end();"/> <s:Button label="Reset" click="resetHandler();"/> </s:VGroup> </s:Panel> </s:Application>
Tue Jun 12 2018, 11:34 AM Z