| Пакет | mx.effects |
| Класс | public class AnimateProperty |
| Наследование | AnimateProperty  TweenEffect Effect EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Например, для эффекта изменения ширины элемента управления Button можно указать width в качестве имени анимируемого свойства, а также определить начальные и конечные значения ширины.
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:AnimateProperty> tag
inherits all the tag attributes of its superclass
and adds the following tag attributes:
<mx:AnimateProperty
id="ID"
fromValue="0"
isStyle="false|true"
property="required"
roundValue="false|true"
toValue="0"
/>
Связанные элементы 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 | |
| fromValue : Number
Начальное значение свойства для эффекта. | AnimateProperty | ||
| hideFocusRing : Boolean
Определяет, должен ли эффект скрыть кольцо фокуса при запуске. | Effect | |
| instanceClass : Class
Объект типа Class, указывающий класс класса экземпляра эффекта для данного класса эффекта. | Effect | |
| isPlaying : Boolean [только для чтения]
Флаг только для чтения, принимающий значение true, если какой-либо экземпляр эффекта воспроизводится в настоящее время, и false в противном случае. | Effect | |
| isStyle : Boolean = false
В случае значения true атрибутом свойства является стиль, этот атрибут устанавливается при использовании метода setStyle(). | AnimateProperty | ||
| perElementOffset : Number
Дополнительная задержка (в миллисекундах) для целевых объектов эффекта, обрабатываемых после первого целевого объекта эффекта. | Effect | |
| playheadTime : Number
Текущая позиция эффекта. | Effect | |
| property : String
Имя свойства целевого объекта, которое используется для анимации. | AnimateProperty | ||
| relevantProperties : Array
Массив имен свойств, используемых при выполнении фильтрации. | Effect | |
| relevantStyles : Array
Массив имен стилей, используемых при выполнении фильтрации. | Effect | |
| repeatCount : int = 1
Число повторов эффекта. | Effect | |
| repeatDelay : int = 0
Время ожидания (в миллисекундах) перед повторением эффекта. | Effect | |
| roundValue : Boolean = false
В случае значения true интерполированное значение для анимации округляется до ближайшего целого числа. | AnimateProperty | ||
| startDelay : int = 0
Время ожидания (в миллисекундах) перед запуском эффекта. | Effect | |
| suspendBackgroundProcessing : Boolean = false
Если значение равно true, блокирует всю фоновую обработку во время воспроизведения эффекта. | Effect | |
| target : Object
Объект, к которому применяется данный эффект. | Effect | |
| targets : Array
Массив объектов, являющихся целевыми объектами эффекта. | Effect | |
| toValue : Number
Конечное значение для эффекта. | AnimateProperty | ||
| triggerEvent : Event
Объект Event, переданный в Effect с помощью EffectManager при запуске эффекта, или null, если эффект воспроизводится без EffectManager. | Effect | |
Защищенные свойства
Общедоступные методы
| Метод | Определено | ||
|---|---|---|---|
AnimateProperty(target:Object = null)
Конструктор. | AnimateProperty | ||
| 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 | |
События
Сведения о свойстве
fromValue | свойство |
public var fromValue:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Начальное значение свойства для эффекта. Значением по умолчанию является текущее значение свойства целевого объекта.
isStyle | свойство |
public var isStyle:Boolean = false| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
В случае значения true атрибутом свойства является стиль, этот атрибут устанавливается при использовании метода setStyle().
Значением по умолчанию является false.
property | свойство |
public var property:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Имя свойства целевого объекта, которое используется для анимации. Этот атрибут является обязательным.
roundValue | свойство |
public var roundValue:Boolean = false| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
В случае значения true интерполированное значение для анимации округляется до ближайшего целого числа. Это свойство рекомендуется применять, если свойство, используемое для анимации, имеет значение int или uint.
Значением по умолчанию является false.
toValue | свойство |
public var toValue:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конечное значение для эффекта. Значением по умолчанию является текущее значение свойства целевого объекта.
Сведения о конструкторе
AnimateProperty | () | Конструктор |
Примеры Использование этого примера
AnimatePropertyEffectExample.mxml
<?xml version="1.0"?>
<!-- Simple example to demonstrate the Halo AnimateProperty effect. -->
<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:Declarations>
<mx:Sequence id="animateScaleXUpDown" >
<mx:AnimateProperty property="scaleX" fromValue="1" toValue="1.5" duration="1000" />
<mx:AnimateProperty property="scaleX" fromValue="1.5" toValue="1" duration="1000" />
</mx:Sequence>
</fx:Declarations>
<s:Panel title="Halo AnimateProperty Effect Example" width="75%" height="75%" >
<s:VGroup left="20" right="20" top="20" bottom="20">
<s:Label width="100%" color="blue"
text="Click on the image to use the AnimateProperty effect with the scaleX property."/>
<mx:Image id="flex" source="@Embed(source='assets/Nokia_6630.png')"
mouseDownEffect="{animateScaleXUpDown}"/>
</s:VGroup>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z