TweenEffect

Пакет	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 expanded

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

The <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

mx.effects.Tween
mx.effects.effectClasses.TweenEffectInstance

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

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

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

	Свойство		Определено
		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

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

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

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

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

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

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

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

	Метод		Определено
		TweenEffect(target:Object = null) Конструктор.	TweenEffect
		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
		tweenEventHandler(event:mx.events:TweenEvent):void Вызывается, когда TweenEffect отправляет TweenEvent.	TweenEffect

События

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

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

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

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
effectEnd	Отправляется в момент завершения воспроизведения экземпляра эффекта, по завершении воспроизведения экземпляра или при прерывании воспроизведения эффекта посредством вызова метода end().	Effect
effectStart	Отправляется в момент начала воспроизведения эффекта.	Effect
effectStop	Отправляется в момент прекращения воспроизведения эффекта, что происходит только в том случае, если воспроизведение эффекта было прервано посредством вызова метода stop().	Effect
tweenEnd	Отправляется по завершении эффекта анимации.	TweenEffect
tweenStart	Отправляется при запуске эффекта анимации, что соответствует первому вызову метода onTweenUpdate().	TweenEffect
tweenUpdate	Отправляется при каждом обновлении целевого объекта эффектом анимации.	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.

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

()

Конструктор

public function TweenEffect(target:Object = null)

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

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

Параметры

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

Сведения о методе

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()`.

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

SimpleTweenEffectExample.mxml

<?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>

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

TweenEffect - AS3 Flex

Классы x

easingFunction

TweenEffect

tweenEventHandler

tweenEnd

tweenStart

tweenUpdate