Zoom

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

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

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

Эффект Zoom увеличивает или уменьшает объект относительно центральной точки.

При применении эффекта Zoom к тексту, визуализируемому с использованием системного шрифта, Flex применяет масштабирование текста в соответствии с целыми размерами кегля. Несмотря на то что использование встроенных шрифтов нежелательно при применении эффекта Zoom к тексту, после применения Zoom к встроенным шрифтам текст выглядит более ровным.

Примечание. Эффект Zoom не работает, если свойство Container.autoLayout имеет значение false.

Синтаксис MXML expanded

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

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

  <mx:Zoom
    id="ID"
    captureRollEvents="false|true"
    originX="Calculated"
    originY="Calculated"
    zoomWidthFrom="0.01"
    zoomWidthTo="1.0"
    zoomHeightFrom="0.01"
    zoomHeightTo="1.0"
  />

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

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

mx.effects.effectClasses.ZoomInstance
mx.managers.LayoutManager

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

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

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

	Свойство		Определено
		captureRollEvents : Boolean Если значение равно true, предотвращает отправку из Flex событий rollOut и rollOver при отсутствии перемещения мыши.	Zoom
		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
		originX : Number Число, представляющее позицию по оси x начала масштабирования, если целевой объект эффекта находится в контейнере с абсолютным позиционированием, например в контейнере Canvas.	Zoom
		originY : Number Число, представляющее позицию по оси y начала масштабирования, если целевой объект эффекта находится в контейнере с абсолютным позиционированием, например в контейнере Canvas.	Zoom
		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
		zoomHeightFrom : Number Число, представляющее масштаб, с которого начинается масштабирование высоты, в виде процентного значения от 0,01 до 1,0.	Zoom
		zoomHeightTo : Number Число, представляющее масштаб, которым завершается масштабирование высоты, в виде процентного значения от 0,01 до 1,0.	Zoom
		zoomWidthFrom : Number Число, представляющее масштаб, с которого начинается масштабирование ширины, в виде процентного значения от 0,01 до 1,0.	Zoom
		zoomWidthTo : Number Число, представляющее масштаб, которым завершается масштабирование ширины, в виде процентного значения от 0,01 до 1,0.	Zoom

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

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

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

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

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

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

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

	Метод		Определено
		Zoom(target:Object = null) Конструктор.	Zoom
		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

Сведения о свойстве

captureRollEvents

свойство

public var captureRollEvents:Boolean

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Если значение равно true, предотвращает отправку из Flex событий rollOut и rollOver при отсутствии перемещения мыши. Устанавливает для этого свойства значение true при использовании эффекта Zoom для уменьшения и увеличения размера целевого объекта.

Например, rollOverEffect используется для запуска эффекта Zoom с целью уменьшения размера целевого объекта. Поскольку размер целевого объекта уменьшается, курсор мыши больше не помещается на целевом объекте, при этом запускается событие rollOut и соответствующий rollOutEffect. Установка для свойства captureRollEvents значения true предотвращает отправку из Flex события rollOut, если только этого не произошло вследствие перемещения мыши.

Значением по умолчанию является false.

originX

свойство

public var originX:Number

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Число, представляющее позицию по оси x начала масштабирования, если целевой объект эффекта находится в контейнере с абсолютным позиционированием, например в контейнере Canvas. Начало масштабирования – это позиция в целевом объекте, относительно которой выполняется центрирование эффекта Zoom

Значение должно находиться в диапазоне от 0 до величины, соответствующей ширине целевого компонента.

По умолчанию используется значение target.width / 2, соответствующее центру целевого объекта.

originY

свойство

public var originY:Number

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Число, представляющее позицию по оси y начала масштабирования, если целевой объект эффекта находится в контейнере с абсолютным позиционированием, например в контейнере Canvas. Начало масштабирования – это позиция в целевом объекте, относительно которой выполняется центрирование эффекта Zoom

Значение должно находиться в диапазоне от 0 до величины, соответствующей высоте целевого компонента.

По умолчанию используется значение target.height / 2, соответствующее центру целевого объекта.

zoomHeightFrom

свойство

public var zoomHeightFrom:Number

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Число, представляющее масштаб, с которого начинается масштабирование высоты, в виде процентного значения от 0,01 до 1,0. Значением по умолчанию является 0,01, которое является очень маленьким.

zoomHeightTo

свойство

public var zoomHeightTo:Number

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Число, представляющее масштаб, которым завершается масштабирование высоты, в виде процентного значения от 0,01 до 1,0. Значением по умолчанию является 1,0, которое соответствует объекту нормального размера.

zoomWidthFrom

свойство

public var zoomWidthFrom:Number

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Число, представляющее масштаб, с которого начинается масштабирование ширины, в виде процентного значения от 0,01 до 1,0. Значением по умолчанию является 0,01, которое является очень маленьким.

zoomWidthTo

свойство

public var zoomWidthTo:Number

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Число, представляющее масштаб, которым завершается масштабирование ширины, в виде процентного значения от 0,01 до 1,0. Значением по умолчанию является 1,0, которое соответствует объекту нормального размера.

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

()

Конструктор

public function Zoom(target:Object = null)

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

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

Параметры

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

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

ZoomEffectExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Zoom 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[
            import flash.events.MouseEvent;

            public function doZoom(event:MouseEvent):void {
                if (zoomAll.isPlaying) {
                    zoomAll.reverse();
                }
                else {
                    // If this is a ROLL_OUT event, play the effect backwards.
                    // If this is a ROLL_OVER event, play the effect forwards.
                    zoomAll.play([event.target], event.type == MouseEvent.ROLL_OUT ? true : false);
                }
            }
        ]]>
    </fx:Script>

    <fx:Declarations>
        <mx:Zoom id="zoomAll" zoomWidthTo="1" zoomHeightTo="1" zoomWidthFrom=".5" zoomHeightFrom=".5"  />
    </fx:Declarations>

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

            <s:Label width="100%" color="blue"
                text="Move the mouse over the image to enlarge it. Move the mouse off of the image to shrink it."/>

            <mx:Image id="img"
                source="@Embed(source='assets/Nokia_6630.png')"
                scaleX=".5" scaleY=".5"
                rollOver="doZoom(event)"
                rollOut="doZoom(event)"/>
        </s:VGroup>

    </s:Panel>
</s:Application>

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

Zoom - AS3 Flex

Классы x

captureRollEvents

originX

originY

zoomHeightFrom

zoomHeightTo

zoomWidthFrom

zoomWidthTo

Zoom