Пакет | mx.effects |
Класс | public class Zoom |
Наследование | Zoom ![]() ![]() ![]() ![]() |
Язык версии: | 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
.

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
Свойство | Определено | ||
---|---|---|---|
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 |
Метод | Определено | ||
---|---|---|---|
Конструктор. | Zoom | ||
![]() | 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 |
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, которое соответствует объекту нормального размера.
Zoom | () | Конструктор |
<?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>
Tue Jun 12 2018, 11:34 AM Z