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

Move  - AS3 Flex

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

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


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

Эффект Move изменяет положение компонента в указанный интервал времени. Можно указать начальную позицию с помощью значений xFrom и yFrom, конечную позицию с помощью xTo и yTo или число пикселей для перемещения компонента посредством xBy и yBy.

При указании любых двух пар значений (начальная позиция, место назначения или расстояние) Flex вычисляет третью пару. Если указаны все три пары значений, Flex игнорирует значения xBy и yBy. Если указаны только значения xTo и yTo или xBy и yBy, Flex назначает текущей позицией объекта значения xFrom и yFrom.

Если для триггера moveEffect указан эффект Move, а шесть значений для свойств From, To и By не установлены, их устанавливает Flex с целью создания плавного перехода между старой и новой позициями объекта.

Как правило, этот эффект применяется к целевому объекту в контейнере, использующем абсолютное позиционирование, таком как Canvas, или в контейнере с layout=absolute, таком как Application или Panel. Если этот эффект применить к целевому объекту в контейнере с автоматическим макетом, таком как VBox или Grid, перемещение произойдет, но в следующий раз при обновлении собственного макета контейнер переместит цель обратно в первоначальную позицию. Для свойства autoLayout контейнера можно установить значение false с целью блокировки обратного перемещения, но это приведет к блокировке всех управляющих элементов в контейнере.

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

The <mx:Move> tag inherits all of the tag attributes of its of its superclass, and adds the following tag attributes:

  <mx:Move
    id="ID"
    xFrom="val" 
    yFrom="val"
    xTo="val"
    yTo="val"
    xBy="val"
    yBy="val"
   />
  

Посмотреть примеры

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



Общедоступные свойства
 СвойствоОпределено
 InheritedclassName : String
[только для чтения] Имя класса эффекта, например Fade.
Effect
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcustomFilter : mx.effects:EffectTargetFilter
Указывает пользовательский объект фильтра типа EffectTargetFilter, используемый эффектом для определения целевых объектов, для которых должен воспроизводиться эффект.
Effect
 Inheritedduration : Number
Продолжительность эффекта в миллисекундах.
Effect
 InheritedeasingFunction : Function = null
Функция замедления для анимации.
TweenEffect
 InheritedeffectTargetHost : mx.effects:IEffectTargetHost
Свойства, позволяющие получить доступ к целевому элементу управления на основе списка для эффекта данных.
Effect
 Inheritedfilter : String
Указывает алгоритм фильтрации целевых объектов для эффекта.
Effect
 InheritedhideFocusRing : Boolean
Определяет, должен ли эффект скрыть кольцо фокуса при запуске.
Effect
 InheritedinstanceClass : Class
Объект типа Class, указывающий класс класса экземпляра эффекта для данного класса эффекта.
Effect
 InheritedisPlaying : Boolean
[только для чтения] Флаг только для чтения, принимающий значение true, если какой-либо экземпляр эффекта воспроизводится в настоящее время, и false в противном случае.
Effect
 InheritedperElementOffset : Number
Дополнительная задержка (в миллисекундах) для целевых объектов эффекта, обрабатываемых после первого целевого объекта эффекта.
Effect
 InheritedplayheadTime : Number
Текущая позиция эффекта.
Effect
 InheritedrelevantProperties : Array
Массив имен свойств, используемых при выполнении фильтрации.
Effect
 InheritedrelevantStyles : Array
Массив имен стилей, используемых при выполнении фильтрации.
Effect
 InheritedrepeatCount : int = 1
Число повторов эффекта.
Effect
 InheritedrepeatDelay : int = 0
Время ожидания (в миллисекундах) перед повторением эффекта.
Effect
 InheritedstartDelay : int = 0
Время ожидания (в миллисекундах) перед запуском эффекта.
Effect
 InheritedsuspendBackgroundProcessing : Boolean = false
Если значение равно true, блокирует всю фоновую обработку во время воспроизведения эффекта.
Effect
 Inheritedtarget : Object
Объект, к которому применяется данный эффект.
Effect
 Inheritedtargets : Array
Массив объектов, являющихся целевыми объектами эффекта.
Effect
 InheritedtriggerEvent : Event
Объект Event, переданный в Effect с помощью EffectManager при запуске эффекта, или null, если эффект воспроизводится без EffectManager.
Effect
  xBy : Number
Число пикселей для перемещения компонентов по оси X.
Move
  xFrom : Number
Координата х начальной позиции.
Move
  xTo : Number
Координата х целевой позиции.
Move
  yBy : Number
Число пикселей для перемещения компонентов вдоль оси y.
Move
  yFrom : Number
Координата у начальной позиции.
Move
  yTo : Number
Координата у целевой позиции.
Move
Защищенные свойства
 СвойствоОпределено
 InheritedapplyTransitionEndProperties : Boolean
Этот флаг указывает, должен ли эффект, воспроизводящийся при переходе, автоматически применить значения свойств, соответствующие конечному состоянию, или сохранить значения, установленные самим эффектом.
Effect
 InheritedendValuesCaptured : Boolean = false
Флаг, содержащий значение true, если конечные значения эффекта уже определены, или значение false, если они должны быть получены из текущих свойств целевых объектов эффекта при воспроизведении эффекта.
Effect
Общедоступные методы
 МетодОпределено
  
Move(target:Object = null)
Конструктор.
Move
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
Обеспечивает сбор текущих значений соответствующих свойств целевых объектов эффекта и сохраняет их как конечные значения.
Effect
 Inherited
Обеспечивает сбор текущих значений соответствующих свойств дополнительного набора целевых объектов. Flex использует эту функцию при воспроизведении эффекта изменения данных.
Effect
 Inherited
Обеспечивает сбор текущих значений соответствующих свойств для целевых объектов эффекта.
Effect
 Inherited
Создает отдельный экземпляр эффекта и инициализирует его.
Effect
 Inherited
createInstances(targets:Array = null):Array
Принимает массив целевых объектов и вызывает метод createInstance() для каждой цели.
Effect
 Inherited
Удаляет прослушиватели событий из экземпляра и удаляет экземпляр из списка экземпляров.
Effect
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
end(effectInstance:IEffectInstance = null):void
Прерывает эффект, воспроизводящийся в настоящее время, и осуществляет немедленный переход в конец эффекта.
Effect
 Inherited
Возвращает массив строк, где каждая строка представляет собой имя свойства, которое было изменено данным эффектом.
Effect
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Приостанавливает эффект до вызова метода resume().
Effect
 Inherited
play(targets:Array = null, playReversedFromEnd:Boolean = false):Array
Начинает воспроизведение эффекта
Effect
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause().
Effect
 Inherited
Если эффект воспроизводится в настоящее время, воспроизводит эффект в обратном порядке, начиная с текущей позиции эффекта.
Effect
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Останавливает эффект, оставляя целевые объекты эффекта в текущем состоянии.
Effect
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
Защищенные методы
 МетодОпределено
 Inherited
applyValueToTarget(target:Object, property:String, value:*, props:Object):void
Используется внутренне инфраструктурой Effect.
Effect
 Inherited
Вызывается по завершении воспроизведения экземпляра эффекта.
Effect
 Inherited
Этот метод вызывается в момент начала воспроизведения эффекта.
Effect
 Inherited
Вызывается при остановке воспроизведения экземпляра эффекта посредством вызова метода stop().
Effect
 Inherited
filterInstance(propChanges:Array, target:Object):Boolean
Определяет логику фильтрации экземпляра эффекта.
Effect
 Inherited
getValueFromTarget(target:Object, property:String):*
Вызывается методом captureStartValues() для получения значения свойства целевого объекта.
Effect
 Inherited
Свойства копий эффекта для экземпляра эффекта.
Effect
 Inherited
Вызывается, когда TweenEffect отправляет TweenEvent.
TweenEffect
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
 InheritedОтправляется в момент завершения воспроизведения экземпляра эффекта, по завершении воспроизведения экземпляра или при прерывании воспроизведения эффекта посредством вызова метода end().Effect
 InheritedОтправляется в момент начала воспроизведения эффекта.Effect
 InheritedОтправляется в момент прекращения воспроизведения эффекта, что происходит только в том случае, если воспроизведение эффекта было прервано посредством вызова метода stop().Effect
 InheritedОтправляется по завершении эффекта анимации.TweenEffect
 InheritedОтправляется при запуске эффекта анимации, что соответствует первому вызову метода onTweenUpdate().TweenEffect
 InheritedОтправляется при каждом обновлении целевого объекта эффектом анимации.TweenEffect
Сведения о свойстве

xBy

свойство
public var xBy:Number

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

Число пикселей для перемещения компонентов по оси X. Значения могут быть отрицательными.

xFrom

свойство 
public var xFrom:Number

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

Координата х начальной позиции.

xTo

свойство 
public var xTo:Number

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

Координата х целевой позиции.

yBy

свойство 
public var yBy:Number

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

Число пикселей для перемещения компонентов вдоль оси y. Значения могут быть отрицательными.

yFrom

свойство 
public var yFrom:Number

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

Координата у начальной позиции.

yTo

свойство 
public var yTo:Number

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

Координата у целевой позиции.

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

Move

()Конструктор
public function Move(target:Object = null)

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

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

Параметры
target:Object (default = null) — Объект, анимируемый с использованием данного эффекта.
MoveEffectExample.mxml
<?xml version="1.0"?>
<!-- Simple example to demonstrate the Halo Move 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:Script>
        <![CDATA[

            private function moveImage():void {
                myMove.end();
                myMove.xTo=mouseX-60;
                myMove.play();
            }
      ]]>
    </fx:Script>

    <fx:Declarations>
        <mx:Move id="myMove" target="{img}"/>
    </fx:Declarations>

    <s:Panel title="Halo Move Effect Example" width="95%" height="95%" >
        <s:VGroup left="20" right="20" top="20" bottom="20">

           <s:Label width="100%" color="blue"
               text="Click anywhere on the canvas to move the phone horizontally to that position"/>

             <mx:Canvas id="canvas" width="100%" height="100%" mouseDown="moveImage();">

                  <mx:Image id="img" source="@Embed(source='assets/Nokia_6630.png')"/>

             </mx:Canvas>
        </s:VGroup>
    </s:Panel>
</s:Application>




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

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