Главная / Action Script 3
Пакетfl.livepreview
Классpublic class LivePreviewParent
НаследованиеLivePreviewParent Inheritance MovieClip Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Класс LivePreviewParent предоставляет временную шкалу для SWC-файла или скомпилированного фрагмента ролика, экспортируемого при выборе ActionScript 3.0.

При установке свойства экземпляра компонента или когда экземпляр компонента изменяет размер на рабочей области, Flash вызывает методы этого класса, которые в свою очередь вызывают методы в коде компонента для установки свойств и размеров компонента.

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

var isLivePreview:Boolean = (parent != null && getQualifiedClassName(parent) == "fl.livepreview::LivePreviewParent");

Класс LivePreviewParent поддерживает определение метода setSize(), использующего значения width и height для изменения размеров компонента. Если метод setSize() не был задан, то этот объект устанавливает свойства width и height индивидуально.

При изменении в средстве разработки Flash размеров просмотра компонента Flash пытается вызвать метод компонента setSize() для просмотра. Если в компоненте не определен метод setSize(), то экземпляр класса LivePreviewParent настраивает свойства width и height компонента индивидуально.

Простейший путь создания файла просмотра компонента — это создание SWC-файла и извлечение просмотра SWF:

Кроме того, можно использовать класс LivePreviewParent для создания пользовательского просмотра SWF-файла без создания SWC-файла. Для создания просмотра компонента этим методом выполните следующие действия.

  1. Создайте новый документ Flash.
  2. Задайте документу класс fl.livepreview.LivePreviewParent.
  3. Переместите компонент на рабочую область и задайте координаты x и y, равные 0.
  4. Убедитесь в том, что параметры компонента сохраняют параметры по умолчанию. Настройки должны сохраниться, если компонент был перемещен из панели библиотеки или из панели компонентов.
  5. В главном меню выберите "Модификация" > "Документ", в параметре "Совпадение" выберите "Содержание".
  6. Нажмите кнопку "ОК".
  7. Опубликуйте файл, чтобы увидеть результат в пользовательском просмотре SWF-файла.
  8. Щелкните правой кнопкой мыши по общему ресурсу панели библиотеки и выберите в контекстном меню "Определение компонента".
  9. Диалоговое окно "Определение компонента" позволяет задать для компонента пользовательский просмотр SWF-файла.

В некоторых случаях может понадобиться пользовательский просмотр SWF-файла, полностью отличающегося от используемого компонента. В качестве примера см. просмотр компонента fl.containers.UILoader. Этот просмотр не использует свойства UILoader, а также не получает и не использует функции для данных свойств. Однако он обеспечивает реализацию метода setSize(), который использует параметры width и height для рисования компонента с новыми размерами.



Общедоступные свойства
 СвойствоОпределено
 InheritedaccessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта.
DisplayObject
 Inheritedalpha : Number
Указывает значение альфа-прозрачности заданного объекта.
DisplayObject
 InheritedblendMode : String
Значение класса BlendMode, задающее режим наложения.
DisplayObject
 InheritedblendShader : Shader
[только для записи] Задает затенение, используемое при наложении переднего плана на фон.
DisplayObject
 InheritedbuttonMode : Boolean
Задает режим кнопки данного спрайта.
Sprite
 InheritedcacheAsBitmap : Boolean
При значении true проигрыватель Flash Player кэширует внутреннее растровое представление экранного объекта.
DisplayObject
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcontextMenu : ContextMenu
Определяет контекстное меню, связанное с данным объектом.
InteractiveObject
 InheritedcurrentFrame : int
[только для чтения] Определяет номер кадра, в котором точка воспроизведения находится на временной шкале экземпляра MovieClip.
MovieClip
 InheritedcurrentFrameLabel : String
[только для чтения] Подпись текущего кадра на временной шкале экземпляра MovieClip.
MovieClip
 InheritedcurrentLabel : String
[только для чтения] Текущая подпись, в которой точка воспроизведения расположена на временной шкале экземпляра MovieClip.
MovieClip
 InheritedcurrentLabels : Array
[только для чтения] Возвращает массив объектов FrameLabel для текущего монтажного кадра.
MovieClip
 InheritedcurrentScene : Scene
[только для чтения] Текущий монтажный кадр, в котором точка воспроизведения расположена на временной шкале экземпляра MovieClip.
MovieClip
 InheriteddoubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick.
InteractiveObject
 InheriteddropTarget : DisplayObject
[только для чтения] Определяет экранный объект, над которым перетаскивается спрайт, либо на котором спрайт был отпущен.
Sprite
 Inheritedenabled : Boolean
Логическое значение, определяющее включение фрагмента ролика.
MovieClip
 Inheritedfilters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом.
DisplayObject
 InheritedfocusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта.
InteractiveObject
 InheritedframesLoaded : int
[только для чтения] Число кадров, загружаемых из потокового SWF-файла.
MovieClip
 Inheritedgraphics : Graphics
[только для чтения] Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования.
Sprite
 Inheritedheight : Number
Указывает высоту экранного объекта в пикселах.
DisplayObject
 InheritedhitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта.
Sprite
 InheritedloaderInfo : LoaderInfo
[только для чтения] Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект.
DisplayObject
 Inheritedmask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask.
DisplayObject
 InheritedmouseChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью мыши.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Определяет, получает ли этот объект сообщения мыши.
InteractiveObject
 InheritedmouseX : Number
[только для чтения] Указывает координату x положения курсора мыши (в пикселах).
DisplayObject
 InheritedmouseY : Number
[только для чтения] Указывает координату y положения курсора мыши (в пикселах).
DisplayObject
  myInstance : DisplayObject
Экземпляр компонента, связанный с просмотром.
LivePreviewParent
 Inheritedname : String
Указывает имя экземпляра DisplayObject.
DisplayObject
 InheritednumChildren : int
[только для чтения] Возвращает число потомков данного объекта.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[только для чтения] Указывает объект DisplayObjectContainer, содержащий данный экранный объект.
DisplayObject
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
 Inheritedroot : DisplayObject
[только для чтения] В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом.
DisplayObject
 Inheritedrotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах).
DisplayObject
 InheritedrotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 InheritedrotationY : Number
Обозначает поворот в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 InheritedrotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 Inheritedscale9Grid : Rectangle
Текущая активная сетка масштабирования.
DisplayObject
 InheritedscaleX : Number
Указывает горизонтальное масштабирование объекта от точки регистрации (в процентах).
DisplayObject
 InheritedscaleY : Number
Указывает вертикальное масштабирование объекта от точки регистрации (в процентах).
DisplayObject
 InheritedscaleZ : Number
Указывает масштабирование глубины объекта (в процентах) относительно точки регистрации этого объекта.
DisplayObject
 Inheritedscenes : Array
[только для чтения] Массив объектов Scene, каждый из которых содержит имя, число кадров и метки кадров для одного из монтажных кадров в экземпляре MovieClip.
MovieClip
 InheritedscrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта.
DisplayObject
 InheritedsoundTransform : SoundTransform
Управляет звуком в данном спрайте.
Sprite
 Inheritedstage : Stage
[только для чтения] Класс Stage экранного объекта.
DisplayObject
 InheritedtabChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью клавиши Tab.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Определяет, включен ли этот объект в последовательность перехода с помощью клавиши Tab.
InteractiveObject
 InheritedtabIndex : int
Задает последовательность перехода между объектами в SWF-файле.
InteractiveObject
 InheritedtextSnapshot : TextSnapshot
[только для чтения] Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 InheritedtotalFrames : int
[только для чтения] Общее число кадров в экземпляре MovieClip.
MovieClip
 InheritedtrackAsMenu : Boolean
Определяет, могут ли другие экранные объекты, являющиеся объектами SimpleButton или MovieClip, получать события отпускания кнопки мыши.
MovieClip
 Inheritedtransform : Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта.
DisplayObject
 InheriteduseHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться указатель "рука" при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true.
Sprite
 Inheritedvisible : Boolean
Определяет видимость экранного объекта.
DisplayObject
 Inheritedwidth : Number
Указывает ширину экранного объекта в пикселах.
DisplayObject
 Inheritedx : Number
Указывает координату x экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer.
DisplayObject
 Inheritedy : Number
Указывает координату y экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer.
DisplayObject
 Inheritedz : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера.
DisplayObject
Общедоступные методы
 МетодОпределено
  
Инициализирует шкалу и режимы выравнивания компонента Stage, устанавливает свойство myInstance и его соответствующий размер, после чего использует класс ExternalInterface для предоставления функций модулю Flash.
LivePreviewParent
 Inherited
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
 Inherited
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой.
DisplayObjectContainer
 Inherited
Определяет, является ли заданный экранный объект дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром.
DisplayObjectContainer
 Inherited
Передает событие в поток событий.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace.
DisplayObject
 Inherited
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса.
DisplayObjectContainer
 Inherited
Возвращает экземпляр дочернего экранного объекта с заданным именем.
DisplayObjectContainer
 Inherited
Возвращает позицию индекса для дочернего экземпляра DisplayObject.
DisplayObjectContainer
 Inherited
Возвращает массив объектов, расположенных ниже заданной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур.
DisplayObject
 Inherited
Преобразует объект Point из координат рабочей области (глобальных) в координаты экранного объекта (локальные).
DisplayObject
 Inherited
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные).
DisplayObject
 Inherited
gotoAndPlay(frame:Object, scene:String = null):void
Запускает воспроизведение SWF-файла с заданного кадра.
MovieClip
 Inherited
gotoAndStop(frame:Object, scene:String = null):void
Переводит точку воспроизведения в заданный кадр фрагмента ролика и останавливает ее в этом кадре.
MovieClip
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Оценивает экранный объект, чтобы определить, перекрывает ли он экранный объект obj или пересекается с ним.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее.
DisplayObject
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными).
DisplayObject
 Inherited
Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные).
DisplayObject
 Inherited
Переводит точку воспроизведения в следующий кадр и останавливает ее.
MovieClip
 Inherited
Перемещает точку воспроизведения в следующий монтажный кадр экземпляра MovieClip.
MovieClip
  
onResize(width:Number, height:Number):void
Устанавливает указанные размеры экземпляра компонента Stage либо путем вызова метода, определенного пользователем, либо устанавливая свойство width и height по отдельности.
LivePreviewParent
  
onUpdate(... updateArray):void
Обновляет свойства экземпляра компонента.
LivePreviewParent
 Inherited
Перемещает точку воспроизведения по временной шкале фрагмента ролика.
MovieClip
 Inherited
Переводит точку воспроизведения в предыдущий кадр и останавливает ее.
MovieClip
 Inherited
Перемещает точку воспроизведения в предыдущий монтажный кадр экземпляра MovieClip.
MovieClip
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Удаляет заданный дочерний объект DisplayObject из списка потомков экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Удаляет дочерний DisplayObject из заданной позиции индекса в списке потомков DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Изменяет положение существующего потомка в DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану).
Sprite
 Inherited
Останавливает точку воспроизведения во фрагменте ролика.
MovieClip
 Inherited
Завершает метод startDrag().
Sprite
 Inherited
Меняет местами (в порядке "от начала к концу") два заданных дочерних объекта.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Меняет местами (в порядке "от начала к концу") дочерние объекты, расположенные в двух заданных позициях индекса в списке потомков.
DisplayObjectContainer
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
 InheritedОтправляется, когда экранный объект добавляется в список отображения.DisplayObject
 InheritedОтправляется, когда экранный объект добавляется к списку отображения в рабочей области, либо непосредственно, либо путем добавления поддерева, содержащего экранный объект.DisplayObject
 InheritedОтправляется, когда пользователь выбирает команду "Удалить" в контекстном меню текста.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Копировать", или выбирает команду "Копировать" из контекстного меню.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вырезать", или выбирает команду "Вырезать" из контекстного меню.InteractiveObject
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
 InheritedОтправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true.InteractiveObject
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр.DisplayObject
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр.DisplayObject
 InheritedОтправляется, когда экранный объект перемещается в фокус.InteractiveObject
 InheritedОтправляется, когда экранный объект покидает фокус.InteractiveObject
 Inherited[многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра.DisplayObject
 InheritedОтправляется, когда пользователь нажимает клавишу.InteractiveObject
 InheritedОтправляется, когда пользователь пытается изменить фокус с помощью клавиатуры.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает клавишу.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь наводит указывающее устройству на экземпляр InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь вращает колесико мыши над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вставить", или выбирает команду "Вставить" из контекстного меню.InteractiveObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения.DisplayObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения, либо непосредственно, либо путем удаления поддерева, содержащего экранный объект.DisplayObject
 Inherited[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения.DisplayObject
 InheritedОтправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Выделить все", или выбирает команду "Выделить все" из контекстного меню.InteractiveObject
 InheritedОтправляется, когда изменяется значение свойства tabChildren объекта.InteractiveObject
 InheritedОтправляется при изменении флага tabEnabled объекта.InteractiveObject
 InheritedОтправляется, когда изменяется значение свойства tabIndex объекта.InteractiveObject
Сведения о свойстве
myInstanceсвойство
public var myInstance:DisplayObject

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Экземпляр компонента, связанный с просмотром. Это свойство внутренне используется для ссылки на экземпляр компонента. Разработчику компонента не требуется устанавливать данное свойство, так как это происходит автоматически при помещении экземпляра компонента на рабочую область.

Сведения о конструкторе
LivePreviewParent()Конструктор
public function LivePreviewParent()

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Инициализирует шкалу и режим выравнивания рабочей области, устанавливает свойство myInstance, изменяет размеры myInstance до требуемых размеров и использует класс ExternalInterface для показа функций во Flash.

Сведения о методе
onResize()метод
public function onResize(width:Number, height:Number):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Устанавливает указанные размеры экземпляра компонента на рабочей области либо путем вызова метода, определенного пользователем, либо устанавливая свойство width и height по отдельности.

Этот метод вызывается инструментом разработки Flash.

Параметры

width:Number — Новая ширина для экземпляра myInstance.
 
height:Number — Новая высота для экземпляра myInstance.

onUpdate()метод 
public function onUpdate(... updateArray):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Обновляет свойства экземпляра компонента. Этот метод вызывается инструментом разработки Flash при изменении значения свойства. Этот метод обновляет все свойства компонента вне зависимости от того, были ли они изменены.

Параметры

... updateArray — Имена и значения массива параметров.