Главная / Action Script 3
Пакетfl.containers
Классpublic class ScrollPane
НаследованиеScrollPane Inheritance BaseScrollPane Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Реализует IFocusManagerComponent

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

Компонент ScrollPane отображает экранные объекты, JPEG-, GIF- и PNG-файлы, а также SWF-файлы в области с прокруткой. Панель прокрутки можно использовать для ограничения области экрана, занятой этими типами материалов. Панель прокрутки может отображать содержимое, которое загружается с локального диска или Интернета. Это содержимое можно настроить с помощью ActionScript как во время разработки, так и при выполнении. После того как панель прокрутки оказывается в фокусе, если содержимое имеет действительные табуляторы, фокус переводится на эти маркеры. Вслед за последним табулятором в содержимом фокус переходит к следующему компоненту. Вертикальная и горизонтальная полосы прокрутки на панели прокрутки не получают фокуса.

Примечание. Когда содержимое загружается из другого домена или изолированной программной среды, свойства содержимого могут быть недоступны по соображениям безопасности. Дополнительную информацию о том, как безопасность домена влияет на процесс загрузки, см. в описании класса Loader.

Примечание. При загрузке очень больших файлов изображений в объект ScrollPane может потребоваться выполнить прослушивание события complete, затем изменить размер ScrollPane, используя метод setSize(). См. пример с событием complete.

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

См. также

Загрузчик


Общедоступные свойства
 СвойствоОпределено
 InheritedaccessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта.
DisplayObject
 Inheritedalpha : Number
Указывает значение альфа-прозрачности заданного объекта.
DisplayObject
 InheritedblendMode : String
Значение класса BlendMode, задающее режим наложения.
DisplayObject
 InheritedblendShader : Shader
[только для записи] Задает затенение, используемое при наложении переднего плана на фон.
DisplayObject
 InheritedbuttonMode : Boolean
Задает режим кнопки данного спрайта.
Sprite
  bytesLoaded : Number
[только для чтения] Определяет объем загруженного содержимого в байтах.
ScrollPane
  bytesTotal : Number
[только для чтения] Определяет общий объем загружаемого содержимого в байтах.
ScrollPane
 InheritedcacheAsBitmap : Boolean
При значении true проигрыватель Flash Player кэширует внутреннее растровое представление экранного объекта.
DisplayObject
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  content : DisplayObject
[только для чтения] Определяет ссылку на содержимое, загруженное на панели прокрутки.
ScrollPane
 InheritedcontextMenu : ContextMenu
Определяет контекстное меню, связанное с данным объектом.
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick.
InteractiveObject
 InheriteddropTarget : DisplayObject
[только для чтения] Определяет экранный объект, над которым перетаскивается спрайт, либо на котором спрайт был отпущен.
Sprite
 Inheritedenabled : Boolean
Определяет или задает значение, указывающее, поддерживает ли компонент взаимодействие с пользователем.
UIComponent
 Inheritedfilters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом.
DisplayObject
 InheritedfocusEnabled : Boolean
Определяет или задает логическое значение, указывающее, может ли компонент принимать фокус при щелчке пользователя.
UIComponent
 InheritedfocusManager : IFocusManager
Определяет или задает объект FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии.
UIComponent
 InheritedfocusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта.
InteractiveObject
 Inheritedgraphics : Graphics
[только для чтения] Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования.
Sprite
 Inheritedheight : Number
Определяет или задает высоту компонента (в пикселах).
UIComponent
 InheritedhitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта.
Sprite
 InheritedhorizontalLineScrollSize : Number
Определяет или задает значение, показывающее протяженность прокрутки по горизонтали при щелчке стрелки прокрутки.
BaseScrollPane
 InheritedhorizontalPageScrollSize : Number
Определяет или задает число пикселов, на которое перемещается бегунок горизонтальной полосы прокрутки при нажатии на рабочую часть полосы прокрутки.
BaseScrollPane
 InheritedhorizontalScrollBar : ScrollBar
[только для чтения] Определяет ссылку на горизонтальную полосу прокрутки.
BaseScrollPane
 InheritedhorizontalScrollPolicy : String
Определяет или задает значение, показывающее состояние горизонтальной полосы прокрутки.
BaseScrollPane
 InheritedhorizontalScrollPosition : Number
Определяет или задает значение, показывающее положение горизонтальной полосы прокрутки на панели прокрутки (в пикселах).
BaseScrollPane
 InheritedloaderInfo : LoaderInfo
[только для чтения] Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект.
DisplayObject
 Inheritedmask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask.
DisplayObject
 InheritedmaxHorizontalScrollPosition : Number
[только для чтения] Определяет максимальную координату (в пикселах) для горизонтальной прокрутки текущего содержимого.
BaseScrollPane
 InheritedmaxVerticalScrollPosition : Number
[только для чтения] Определяет максимальное положение по вертикали при прокрутке текущего содержимого (в пикселах).
BaseScrollPane
 InheritedmouseChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью мыши.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Определяет, получает ли этот объект сообщения мыши.
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
Определяет или задает значение, указывающее, может ли компонент принимать фокус при щелчке пользователя.
UIComponent
 InheritedmouseX : Number
[только для чтения] Указывает координату x положения курсора мыши (в пикселах).
DisplayObject
 InheritedmouseY : Number
[только для чтения] Указывает координату y положения курсора мыши (в пикселах).
DisplayObject
 Inheritedname : String
Указывает имя экземпляра DisplayObject.
DisplayObject
 InheritednumChildren : int
[только для чтения] Возвращает число потомков данного объекта.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[только для чтения] Указывает объект DisplayObjectContainer, содержащий данный экранный объект.
DisplayObject
  percentLoaded : Number
[только для чтения] Определяет число, показывающее объем загруженной части содержимого (от 0 до 100 %).
ScrollPane
 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
Умножает текущую ширину компонента на коэффициент масштабирования.
UIComponent
 InheritedscaleY : Number
Умножает текущую высоту компонента на коэффициент масштабирования.
UIComponent
 InheritedscaleZ : Number
Указывает масштабирование глубины объекта (в процентах) относительно точки регистрации этого объекта.
DisplayObject
  scrollDrag : Boolean
Определяет или задает значение, указывающее, производится ли прокрутка при перетаскивании содержимого на панели прокрутки.
ScrollPane
 InheritedscrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта.
DisplayObject
 InheritedsoundTransform : SoundTransform
Управляет звуком в данном спрайте.
Sprite
  source : Object
Определяет или задает абсолютный или относительный URL-адрес расположения SWF-файла или файла изображения для загрузки, имя класса фрагмента ролика из библиотеки, ссылку на экранный объект или имя экземпляра фрагмента ролика на одном уровне с компонентом.
ScrollPane
 Inheritedstage : Stage
[только для чтения] Класс Stage экранного объекта.
DisplayObject
 InheritedtabChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью клавиши Tab.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Определяет, включен ли этот объект в последовательность перехода с помощью клавиши Tab.
InteractiveObject
 InheritedtabIndex : int
Задает последовательность перехода между объектами в SWF-файле.
InteractiveObject
 InheritedtextSnapshot : TextSnapshot
[только для чтения] Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inheritedtransform : Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта.
DisplayObject
 InheriteduseBitmapScrolling : Boolean
При значении true свойству cacheAsBitmap для прокручиваемого содержимого устанавливается значение true. При значении false данное значение отключается.
BaseScrollPane
 InheriteduseHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться указатель "рука" при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true.
Sprite
 Inheritedversion : String = "3.0.0.16"
Номер версии компонентов.
UIComponent
 InheritedverticalLineScrollSize : Number
Определяет или задает значение, показывающее число пикселов, на которое производится прокрутка по вертикали при щелчке стрелки прокрутки.
BaseScrollPane
 InheritedverticalPageScrollSize : Number
Определяет или задает число пикселов, на которое перемещается бегунок вертикальной полосы прокрутки при нажатии на рабочую часть полосы прокрутки.
BaseScrollPane
 InheritedverticalScrollBar : ScrollBar
[только для чтения] Определяет ссылку на вертикальную полосу прокрутки.
BaseScrollPane
 InheritedverticalScrollPolicy : String
Определяет или задает значение, показывающее состояние вертикальной полосы прокрутки.
BaseScrollPane
 InheritedverticalScrollPosition : Number
Определяет или задает значение, показывающее положение вертикальной полосы прокрутки на панели прокрутки (в пикселах).
BaseScrollPane
 Inheritedvisible : Boolean
Определяет или задает значение, указывающее, видим ли текущий экземпляр компонента.
UIComponent
 Inheritedwidth : Number
Определяет или задает ширину компонента (в пикселах).
UIComponent
 Inheritedx : Number
Определяет или задает координату, представляющую положение компонента по оси X в пределах родительского контейнера.
UIComponent
 Inheritedy : Number
Определяет или задает координату, представляющую положение компонента по оси Y в пределах родительского контейнера.
UIComponent
 Inheritedz : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера.
DisplayObject
Общедоступные методы
 МетодОпределено
  
Создает новый экземпляр компонента ScrollPane.
ScrollPane
 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
Удаляет свойство style для экземпляра компонента.
UIComponent
 Inherited
Определяет, является ли заданный экранный объект дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром.
DisplayObjectContainer
 Inherited
Передает событие в поток событий.
EventDispatcher
 Inherited
Отображает или скрывает индикатор фокуса этого компонента.
UIComponent
 Inherited
Инициирует немедленную операцию отрисовки без аннулирования всех элементов (в отличие от метода invalidateNow).
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace.
DisplayObject
 Inherited
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса.
DisplayObjectContainer
 Inherited
Возвращает экземпляр дочернего экранного объекта с заданным именем.
DisplayObjectContainer
 Inherited
Возвращает позицию индекса для дочернего экземпляра DisplayObject.
DisplayObjectContainer
 Inherited
Возвращает объект, который в настоящее время имеет фокус.
UIComponent
 Inherited
Возвращает массив объектов, расположенных ниже заданной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур.
DisplayObject
 Inherited
Возвращает свойство style, установленное в последовательности для поиска стилей компонента.
UIComponent
  
[статические] Возвращает карту стилей по умолчанию для текущего компонента.
ScrollPane
 Inherited
Преобразует объект Point из координат рабочей области (глобальных) в координаты экранного объекта (локальные).
DisplayObject
 Inherited
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные).
DisplayObject
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Оценивает экранный объект, чтобы определить, перекрывает ли он экранный объект obj или пересекается с ним.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее.
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
Помечает свойство как недопустимое и обновляет компонент в следующем кадре, если не указано иное.
UIComponent
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
load(request:URLRequest, context:LoaderContext = null):void
Параметр запроса для этого метода принимает только объект URLRequest, свойство source которого содержит строку, класс или объект URLRequest.
ScrollPane
 Inherited
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными).
DisplayObject
 Inherited
Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные).
DisplayObject
 Inherited
[статические] Объединяет стили из нескольких классов в одном объекте.
UIComponent
 Inherited
Перемещает компонент в указанное положение в пределах его родительского компонента.
UIComponent
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
Повторно загружает содержимое панели прокрутки.
ScrollPane
 Inherited
Удаляет заданный дочерний объект DisplayObject из списка потомков экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Удаляет дочерний DisplayObject из заданной позиции индекса в списке потомков DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Изменяет положение существующего потомка в DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Задает фокус на этот компонент.
UIComponent
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
setSize(width:Number, height:Number):void
Задает указанную высоту и ширину компонента.
UIComponent
 Inherited
setStyle(style:String, value:Object):void
Задает свойство style для экземпляра компонента.
UIComponent
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану).
Sprite
 Inherited
Завершает метод startDrag().
Sprite
 Inherited
Меняет местами (в порядке "от начала к концу") два заданных дочерних объекта.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Меняет местами (в порядке "от начала к концу") дочерние объекты, расположенные в двух заданных позициях индекса в списке потомков.
DisplayObjectContainer
 Inherited
Возвращает строковое представление заданного объекта.
Object
  
Обновляет свойства полосы прокрутки в зависимости от ширины и высоты содержимого.
ScrollPane
 Inherited
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его при необходимости.
UIComponent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
Защищенные методы
 МетодОпределено
 Inherited
Возвращает указанный стиль для компонента, учитывая все стили, заданные на глобальном уровне, уровне компонентов и уровне экземпляров.
UIComponent
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
 InheritedОтправляется, когда экранный объект добавляется в список отображения.DisplayObject
 InheritedОтправляется, когда экранный объект добавляется к списку отображения в рабочей области, либо непосредственно, либо путем добавления поддерева, содержащего экранный объект.DisplayObject
 InheritedОтправляется, когда пользователь выбирает команду "Удалить" в контекстном меню текста.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject.InteractiveObject
  Отправляется после завершения загрузки содержимого.ScrollPane
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Копировать", или выбирает команду "Копировать" из контекстного меню.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вырезать", или выбирает команду "Вырезать" из контекстного меню.InteractiveObject
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
 InheritedОтправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true.InteractiveObject
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр.DisplayObject
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр.DisplayObject
 InheritedОтправляется, когда экранный объект перемещается в фокус.InteractiveObject
 InheritedОтправляется, когда экранный объект покидает фокус.InteractiveObject
 Inherited[многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра.DisplayObject
 InheritedОтправляется, когда видимый компонент становится невидимым.UIComponent
  Отправляется, когда свойства и методы загруженного SWF-файла становятся доступны.ScrollPane
  Отправляется при возникновении ошибки ввода-вывода.ScrollPane
 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Отправляется при перемещении компонента.UIComponent
  Отправляется при запуске сетевой операции.ScrollPane
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вставить", или выбирает команду "Вставить" из контекстного меню.InteractiveObject
  Отправляется во время загрузки содержимого.ScrollPane
  Отправляется во время загрузки содержимого.ScrollPane
 InheritedОтправляется перед удалением экранного объекта из списка отображения.DisplayObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения, либо непосредственно, либо путем удаления поддерева, содержащего экранный объект.DisplayObject
 Inherited[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения.DisplayObject
 InheritedОтправляется при изменении размеров компонента.UIComponent
 InheritedОтправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject.InteractiveObject
   Задает значение свойства type для объекта события Scroll.ScrollPane
  Отправляется, если при загрузке содержимого возникает ошибка системы безопасности.ScrollPane
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Выделить все", или выбирает команду "Выделить все" из контекстного меню.InteractiveObject
 InheritedОтправляется, когда невидимый компонент становится видимым.UIComponent
 InheritedОтправляется, когда изменяется значение свойства tabChildren объекта.InteractiveObject
 InheritedОтправляется при изменении флага tabEnabled объекта.InteractiveObject
 InheritedОтправляется, когда изменяется значение свойства tabIndex объекта.InteractiveObject
Стили
 Стиль Описание Определено
  
contentPadding
Тип: Number Формат: Length
Количество заполнителя, размещаемого вокруг содержимого на панели прокрутки, в пикселах. Значение по умолчанию 0.
ScrollPane
 InheritedТип: Number Формат: Length
Если свойству enabled присвоено значение false, взаимодействие с компонентом запрещено, а поверх него накладывается белый слой, делающий содержимое компонента тусклым.
BaseScrollPane
  
disabledSkin
Тип: Class
Обложка, которая отображается, когда выключена панель прокрутки. Значение по умолчанию ScrollPane_disabledSkin.
ScrollPane
 InheritedТип: flash.text.TextFormat
Объект TextFormat, который используется для визуализации метки компонента, когда кнопка отключена.
UIComponent
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки, когда она отключена.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки, когда пользователь нажимает на кнопку.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки, когда курсор находится над кнопкой.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки.
BaseScrollPane
 InheritedТип: Number Формат: Length
Заполнитель, отделяющий внешние границы компонента от внешних краев индикатора фокуса, в пикселах.
UIComponent
 InheritedТип: Class
Обложка, используемая для показа индикаторов фокуса.
UIComponent
 InheritedТип: Number Формат: Time
Количество миллисекунд ожидания, которое проходит после того, как событие buttonDown впервые отправляется перед отправкой второго события buttonDown.
BaseScrollPane
 InheritedТип: Number Формат: Time
Интервал в миллисекундах между событиями buttonDown, которые отправляются после задержки, указанной с помощью стиля repeatDelay.
BaseScrollPane
 InheritedТип: Class
Обложка, используемая в качестве фона панели прокрутки.
BaseScrollPane
 InheritedТип: flash.text.TextFormat
Объект TextFormat, используемый для визуализации метки компонента.
UIComponent
 InheritedТип: Class
Обложка, используемая для указания отключенного состояния бегунка.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для бегунка полосы прокрутки при нажатии на бегунок.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве значка для бегунка полосы прокрутки.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для бегунка полосы прокрутки, когда курсор находится над бегунком.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для бегунка полосы прокрутки.
BaseScrollPane
 InheritedТип: Class
Обложка, используемая для указания отключенной дорожки.
BaseScrollPane
 InheritedТип: Class
Обложка, используемая для того, чтобы указать состояние нажатой кнопки мыши для отключенной обложки.
BaseScrollPane
 InheritedТип: Class
Обложка, используемая для того, чтобы указать состояние курсора, находящегося над дорожкой прокрутки.
BaseScrollPane
 InheritedТип: Class
Обложка, используемая для того, чтобы указать состояние ненажатой кнопки мыши для дорожки прокрутки.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки, когда она отключена.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки, когда пользователь нажимает ее.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки, когда курсор находится над кнопкой со стрелкой.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки.
BaseScrollPane
  
upSkin
Тип: Class
Обложка по умолчанию, показываемая на панели прокрутки. Значение по умолчанию ScrollPane_upSkin.
ScrollPane
Сведения о свойстве
bytesLoadedсвойство
bytesLoaded:Number  [только для чтения]

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

Определяет объем загруженного содержимого в байтах. Когда этому свойству присваивается значение, равное значению bytesTotal, загружается все содержимое.

Значение по умолчанию 0



Реализация
    public function get bytesLoaded():Number

См. также


Пример
В следующем примере создается панель прокрутки, в которую загружается файл test.jpg. Во время загрузки на панели "Вывод" отображается количество загруженных байтов и общее количество байтов. Кроме того, процесс загрузки наглядно изображен на индикаторе выполнения. Замените файл test.jpg изображением и поместите классы ScrollPane и ProgressBar в библиотеку FLA-файла:

import fl.containers.ScrollPane;
import fl.controls.ProgressBar;

var path:String = "test.jpg";

var sp:ScrollPane = new ScrollPane();
sp.move(10,10);
sp.setSize(530,300);
sp.addEventListener(ProgressEvent.PROGRESS,reportProgress);
sp.load(new URLRequest(path));
addChild(sp);

var progressBar:ProgressBar = new ProgressBar();
progressBar.move(10,320);
progressBar.setSize(530,50);
progressBar.source = sp;
addChild(progressBar);

function reportProgress(e:ProgressEvent):void {
    trace(e.bytesLoaded + " loaded out of " + e.bytesTotal);
}
bytesTotalсвойство 
bytesTotal:Number  [только для чтения]

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

Определяет общий объем загружаемого содержимого в байтах.

Значение по умолчанию 0



Реализация
    public function get bytesTotal():Number

См. также


Пример
В примере ниже внешнее изображение загружается в экземпляр ScrollPane и отображает свойства bytesLoaded, bytesTotal и percentLoaded при появлении событий progress и complete:

import fl.containers.ScrollPane;

var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
myScrollPane.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
myScrollPane.load(new URLRequest(url));
addChild(myScrollPane);

function progressHandler(event:ProgressEvent):void {
    var bLoaded:int = event.bytesLoaded;
    var bTotal:int = event.bytesTotal;
    var pctLoaded:int = int(event.currentTarget.percentLoaded);
    trace("progress: " + bLoaded + " of " + bTotal + " bytes loaded (" + pctLoaded + "%)");
}

function completeHandler(event:Event):void {
    trace("complete:");
}
contentсвойство 
content:DisplayObject  [только для чтения]

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

Определяет ссылку на содержимое, загруженное на панели прокрутки.

Значение по умолчанию null



Реализация
    public function get content():DisplayObject

Пример
В следующем примере показано, как модифицировать прозрачность содержимого на панели прокрутки:

import fl.containers.ScrollPane;
import fl.controls.NumericStepper;

var ns:NumericStepper = new NumericStepper();
ns.minimum = 10;
ns.maximum = 100;
ns.stepSize = 10;
ns.value = ns.maximum;
ns.addEventListener(Event.CHANGE, updateScrollPaneContentAlpha);
addChild(ns);

var sp:ScrollPane = new ScrollPane();
sp.move(0,30);
sp.setSize(180, 160);
sp.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(sp);

function updateScrollPaneContentAlpha(e:Event):void {
    sp.content.alpha = e.target.value / 100;
}
В следующем примере используются два экземпляра компонента Button, определяющие степень увеличения изображения в компоненте ScrollPane.

import fl.containers.ScrollPane;
import fl.controls.Button;
import fl.events.ComponentEvent;

var MAX_SCROLLPANE_WIDTH:uint = 400;
var MAX_SCROLLPANE_HEIGHT:uint = 267;

var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.scrollDrag = true;
myScrollPane.cacheAsBitmap = true;
myScrollPane.setSize(MAX_SCROLLPANE_WIDTH, MAX_SCROLLPANE_HEIGHT);
myScrollPane.move(10, 10);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
myScrollPane.load(new URLRequest(url));
addChild(myScrollPane);

var zoomInButton:Button = new Button();
zoomInButton.autoRepeat = true;
zoomInButton.enabled = false;
zoomInButton.label = "Zoom in (+)";
zoomInButton.move(420, 10);
zoomInButton.addEventListener(ComponentEvent.BUTTON_DOWN, zoomInHandler);
addChild(zoomInButton);

var zoomOutButton:Button = new Button();
zoomOutButton.autoRepeat = true;
zoomOutButton.enabled = false;
zoomOutButton.label = "Zoom out (-)";
zoomOutButton.move(420, 40);
zoomOutButton.addEventListener(ComponentEvent.BUTTON_DOWN, zoomOutHandler);
addChild(zoomOutButton);

var cacheButton:Button = new Button();
cacheButton.enabled = false;
cacheButton.emphasized = myScrollPane.cacheAsBitmap;
cacheButton.label = "cacheAsBitmap";
cacheButton.toggle = true;
cacheButton.selected = myScrollPane.cacheAsBitmap;
cacheButton.move(420, 70);
cacheButton.addEventListener(Event.CHANGE, changeHandler);
addChild(cacheButton);

function completeHandler(event:Event):void {
    zoomInButton.enabled = true;
    zoomOutButton.enabled = true;
    cacheButton.enabled = true;
    myScrollPane.removeEventListener(Event.COMPLETE, completeHandler);
}

function changeHandler(event:Event):void {
    myScrollPane.cacheAsBitmap = !myScrollPane.cacheAsBitmap;
    cacheButton.emphasized = myScrollPane.cacheAsBitmap;
}

function zoomInHandler(event:ComponentEvent):void {
    var zoomLvl:Number = myScrollPane.content.scaleX * 1.1;
    updateSP(zoomLvl);
}

function zoomOutHandler(event:ComponentEvent):void {
    var zoomLvl:Number = myScrollPane.content.scaleX / 1.1;
    updateSP(zoomLvl);
}

function updateSP(newScale:Number):void {
    var img:DisplayObject = myScrollPane.content as DisplayObject;
    img.scaleY = newScale;
    img.scaleX = newScale;
    myScrollPane.width = Math.min(img.width, MAX_SCROLLPANE_WIDTH);
    myScrollPane.height = Math.min(img.height, MAX_SCROLLPANE_HEIGHT);
    myScrollPane.update();
}
percentLoadedсвойство 
percentLoaded:Number  [только для чтения]

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

Определяет число, показывающее объем загруженной части содержимого (от 0 до 100 %). Если ресурсы загружаются из библиотеки, а не являются содержимым из внешних источников, свойству percentLoaded присваивается значение 0.

Значение по умолчанию 0



Реализация
    public function get percentLoaded():Number

См. также


Пример
В примере ниже внешнее изображение загружается в экземпляр ScrollPane и отображает свойства bytesLoaded, bytesTotal и percentLoaded при появлении событий progress и complete:

import fl.containers.ScrollPane;

var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
myScrollPane.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
myScrollPane.load(new URLRequest(url));
addChild(myScrollPane);

function progressHandler(event:ProgressEvent):void {
    var bLoaded:int = event.bytesLoaded;
    var bTotal:int = event.bytesTotal;
    var pctLoaded:int = int(event.currentTarget.percentLoaded);
    trace("progress: " + bLoaded + " of " + bTotal + " bytes loaded (" + pctLoaded + "%)");
}

function completeHandler(event:Event):void {
    trace("complete:");
}
scrollDragсвойство 
scrollDrag:Boolean  [чтение и запись]

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

Определяет или задает значение, указывающее, производится ли прокрутка при перетаскивании содержимого на панели прокрутки. Значение true указывает на то, что прокрутка выполняется только тогда, когда пользователь перетаскивает содержимое; значение false указывает на то, что она не происходит.

Значение по умолчанию false



Реализация
    public function get scrollDrag():Boolean
    public function set scrollDrag(value:Boolean):void

См. также


Пример
В примере ниже создается экземпляр ScrollPane и отслеживаются положения горизонтальной и вертикальной прокрутки компонента при просмотре содержимого:

import fl.containers.ScrollPane;
import fl.events.ScrollEvent;

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.scrollDrag = true;
myScrollPane.source = "http://www.helpexamples.com/flash/images/image2.jpg";
myScrollPane.addEventListener(ScrollEvent.SCROLL, scrollHandler);
myScrollPane.move(10, 10);
addChild(myScrollPane);

function scrollHandler(event:ScrollEvent):void {
    var mySP:ScrollPane = event.currentTarget as ScrollPane;
    trace("scrolling");
    trace("\t" + "direction:", event.direction);
    trace("\t" + "position:", event.position);
    trace("\t" + "horizontalScrollPosition:", mySP.horizontalScrollPosition, "of", mySP.maxHorizontalScrollPosition);
    trace("\t" + "verticalScrollPosition:", mySP.verticalScrollPosition, "of", mySP.maxVerticalScrollPosition);
}
sourceсвойство 
source:Object  [чтение и запись]

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

Определяет или задает абсолютный или относительный URL-адрес расположения SWF-файла или файла изображения для загрузки, имя класса фрагмента ролика из библиотеки, ссылку на экранный объект или имя экземпляра фрагмента ролика на одном уровне с компонентом.

Допускаются форматы изображения GIF, PNG и JPEG. Чтобы загрузить ресурс с помощью URLRequest, воспользуйтесь методом load().

Значение по умолчанию null



Реализация
    public function get source():Object
    public function set source(value:Object):void

См. также


Пример
В следующем примере внешнее изображение загружается в компонент ScrollPane с помощью свойства source:

import fl.containers.ScrollPane;

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
addChild(myScrollPane);
В примере ниже символ фрагмента ролика загружается из библиотеки в компонент ScrollPane с помощью свойства source:

import fl.containers.ScrollPane;

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.source = Box;
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
addChild(myScrollPane);
Сведения о конструкторе
ScrollPane()Конструктор
public function ScrollPane()

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

Создает новый экземпляр компонента ScrollPane.

Сведения о методе
getStyleDefinition()метод
public static function getStyleDefinition():Object

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

Возвращает карту стилей по умолчанию для текущего компонента. Карта стилей содержит тип, который подходит для компонента в зависимости от стиля, используемого компонентом. Например, стиль disabledTextFormat содержит значение null или объект TextFormat. Вы можете воспользоваться этими стилями и вызвать метод setStyle() по отношению к текущему компоненту. Следующий код переопределяет стиль disabledTextFormat, выбранный по умолчанию для указанного компонента:

componentInstance.setStyle("disabledTextFormat", new TextFormat());

Возвращает
Object — Объект стилей по умолчанию.

См. также


Пример

В следующем примере создается обозреватель стилей для нескольких классов компонентов:
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}
load()метод 
public function load(request:URLRequest, context:LoaderContext = null):void

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

Параметр запроса для этого метода принимает только объект URLRequest, свойство source которого содержит строку, класс или объект URLRequest. По умолчанию для объекта LoaderContext текущий домен используется как домен приложения. Чтобы указать другое значение домена приложения, проверить файл политики или изменить домен защиты, инициализируйте новый объект LoaderContext и передайте его этому методу.

Параметры

request:URLRequest — Объект URLRequest, используемый для загрузки изображения на панель прокрутки.
 
context:LoaderContext (default = null) — Объект LoaderContext, настраивающий контекст операции загрузки.

См. также


Пример

В следующем примере изображение загружается на панель прокрутки:
import fl.containers.ScrollPane;

var request:URLRequest = new URLRequest("http://www.helpexamples.com/flash/images/image1.jpg");
var sp:ScrollPane = new ScrollPane();
sp.setSize(180, 160);
sp.load(request);
addChild(sp);
refreshPane()метод 
public function refreshPane():void

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

Повторно загружает содержимое панели прокрутки.

Этот метод не приводит к перерисовке полосы прокрутки. Сбросить положение полосы прокрутки можно с помощью метода update().

См. также


Пример

В следующем примере изображение загружается в экземпляр компонента ScrollPane, а панель обновляется благодаря методу refreshPane():

import fl.containers.ScrollPane;
import fl.controls.Button;
import fl.controls.TextArea;

var url:String = "http://www.helpexamples.com/flash/images/image2.jpg";

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
myScrollPane.load(new URLRequest(url));
myScrollPane.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
addChild(myScrollPane);

var refreshButton:Button = new Button();
refreshButton.emphasized = true;
refreshButton.label = "refreshPane()";
refreshButton.move(myScrollPane.x + myScrollPane.width + 10, myScrollPane.y);
refreshButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(refreshButton);

var myTextArea:TextArea = new TextArea();
myTextArea.editable = false;
myTextArea.setSize(320, 120);
myTextArea.move(myScrollPane.x, myScrollPane.y + myScrollPane.height + 10);
addChild(myTextArea);

function progressHandler(event:ProgressEvent):void {
    var bLoaded:int = event.bytesLoaded;
    var bTotal:int = event.bytesTotal;
    var pctLoaded:int = int(event.currentTarget.percentLoaded);
    addText("progress (" + bLoaded + " of " + bTotal + " bytes loaded -- " + pctLoaded + "%)");
}

function completeHandler(event:Event):void {
    addText("complete");
    addText("----------");
}

function clickHandler(event:MouseEvent):void {
    myScrollPane.refreshPane();
}

function addText(str:String):void {
    myTextArea.appendText(str + "\n");
    myTextArea.verticalScrollPosition = myTextArea.maxVerticalScrollPosition;
}
update()метод 
public function update():void

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

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

См. также


Пример

В следующем примере создается экземпляр компонента ScrollPane и загружаются различные изображения, выбор которых выполняется на основе нажатых пользователем кнопок:

import fl.containers.ScrollPane;
import fl.controls.Button;

var baseURL:String = "http://www.helpexamples.com/flash/images/";

var img1Button:Button = new Button();
img1Button.label = "Image 1";
img1Button.move(10, 10);
img1Button.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(img1Button);

var img2Button:Button = new Button();
img2Button.label = "Image 2";
img2Button.move(10, 40);
img2Button.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(img2Button);

var img3Button:Button = new Button();
img3Button.label = "Image 3";
img3Button.move(10, 70);
img3Button.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(img3Button);

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(120, 10);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
addChild(myScrollPane);

function clickHandler(event:MouseEvent):void {
    switch (event.currentTarget) {
        case img1Button:
            myScrollPane.source = baseURL + "image1.jpg";
            break;
        case img2Button:
            myScrollPane.source = baseURL + "image2.jpg";
            break;
        case img3Button:
            myScrollPane.source = baseURL + "image3.jpg";
            break;
    }
}

function completeHandler(event:Event):void {
    myScrollPane.update();
}
Сведения о событии
complete Событие
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.COMPLETE

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

Отправляется после завершения загрузки содержимого.

Константа Event.COMPLETE определяет значение свойства type объекта complete.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, который завершил загрузку.

Пример

В следующем примере создается экземпляр компонента ScrollPane, загружается внешнее изображение и выполняется прослушивание событий progress и complete. По завершении загрузки изображения размер ScrollPane изменяется (при помощи метода setSize()), объект помещается в центр рабочей области и добавляется в список отображения.

import fl.containers.ScrollPane;
import fl.controls.Label;

var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";

var conversion:Number = 1024;

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
myScrollPane.load(new URLRequest(url));

function progressHandler(event:ProgressEvent):void {
    var bLoaded:int = int(event.bytesLoaded / conversion);
    var bTotal:int = int(event.bytesTotal / conversion);
    var pctLoaded:int = event.target.percentLoaded as int;
    myLabel.text = bLoaded + " of " + bTotal + " (" + pctLoaded + "%)";
}

function completeHandler(event:Event):void {
    var img:DisplayObject = myScrollPane.content;
    
    myScrollPane.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myScrollPane.removeEventListener(Event.COMPLETE, completeHandler);
    removeChild(myLabel);

    myScrollPane.setSize(img.width, img.height);
    var newX:uint = (stage.stageWidth - myScrollPane.width) / 2;
    var newY:uint = (stage.stageHeight - myScrollPane.height) / 2;
    myScrollPane.move(newX, newY);
    addChild(myScrollPane);
}

См. также

init Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.INIT

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

Отправляется, когда свойства и методы загруженного SWF-файла становятся доступны. Отправка этого события выполняется при следующих условиях:

Константа Event.INIT определяет значение свойства typeобъекта события init.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект LoaderInfo, связанный с загружаемым SWF-файлом.
ioError Событие  
Тип объекта события: flash.events.IOErrorEvent
свойство IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

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

Отправляется при возникновении ошибки ввода-вывода.

Задает значение свойства type для объекта события ioError.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, с которым произошла ошибка ввода/вывода.
textТекст, отображаемый в качестве сообщения об ошибке.

Пример

В следующем примере создается экземпляр компонента UILoader и предпринимается попытка загрузить несуществующий файл, которая приводит к отправке события ioError:

import fl.containers.UILoader;

var url:String = "http://www.helpexamples.com/flash/images/image404.jpg"

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.move(10, 10);
myUILoader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
addChild(myUILoader);

function ioErrorHandler(event:IOErrorEvent):void {
    trace("<<", event.text, ">>");
    myUILoader.removeEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
    removeChild(myUILoader);
}
open Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.OPEN

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

Отправляется при запуске сетевой операции.

Константа Event.OPEN определяет значение свойства type объекта события open.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, установивший подключение.
progress Событие  
Тип объекта события: flash.events.ProgressEvent
свойство ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

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

Отправляется во время загрузки содержимого. Это событие отправляется независимо от того, была ли операция загрузки запущена процессом автоматической загрузки или путем прямого вызова метода load().

Задает значение свойства type для объекта события progress.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
bytesLoadedЧисло элементов или байт, загруженных на момент обработки события прослушивателем.
bytesTotalОбщее число элементов или байт, которые в итоге будут получены в случае успешного завершения загрузки.
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, сообщающий сведения о прогрессе.

Пример

В следующем примере создается экземпляр компонента UILoader для показа загруженного изображения, а также экземпляры компонентов ProgressBar и Label, которые отображают текущее состояние загрузки изображения:

import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

См. также

progress Событие  
Тип объекта события: flash.events.ProgressEvent
свойство ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

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

Отправляется во время загрузки содержимого.

Задает значение свойства type для объекта события progress.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
bytesLoadedЧисло элементов или байт, загруженных на момент обработки события прослушивателем.
bytesTotalОбщее число элементов или байт, которые в итоге будут получены в случае успешного завершения загрузки.
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, сообщающий сведения о прогрессе.

Пример

В примере ниже внешнее изображение загружается в экземпляр ScrollPane и отображает свойства bytesLoaded, bytesTotal и percentLoaded при появлении событий progress и complete:

import fl.containers.ScrollPane;

var url:String = "http://www.helpexamples.com/flash/images/image1.jpg";

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
myScrollPane.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myScrollPane.addEventListener(Event.COMPLETE, completeHandler);
myScrollPane.load(new URLRequest(url));
addChild(myScrollPane);

function progressHandler(event:ProgressEvent):void {
    var bLoaded:int = event.bytesLoaded;
    var bTotal:int = event.bytesTotal;
    var pctLoaded:int = int(event.currentTarget.percentLoaded);
    trace("progress: " + bLoaded + " of " + bTotal + " bytes loaded (" + pctLoaded + "%)");
}

function completeHandler(event:Event):void {
    trace("complete:");
}

См. также

scroll Событие  
Тип объекта события: fl.events.ScrollEvent
свойство ScrollEvent.type = fl.events.ScrollEvent.SCROLL

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

Отправляется при прокрутке содержимого с помощью полос прокрутки компонента или колеса мыши.

Задает значение свойства type для объекта события scroll.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
delta1; значение, указывающее величину прокрутки.
directionvertical; направление объекта ScrollBar.
position0; положение бегунка Scrollbar после того, как он был перемещен.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

Пример

В следующем примере выполняется ожидание события scroll, а свойство direction класса ScrollEvent помогает определить, выполнялась ли прокрутка по горизонтали или по вертикали:

import fl.containers.ScrollPane;
import fl.events.ScrollEvent;
import fl.controls.ScrollBarDirection;

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.scrollDrag = true;
myScrollPane.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myScrollPane.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myScrollPane);

function scrollHandler(event:ScrollEvent):void {
    switch (event.direction) {
        case ScrollBarDirection.HORIZONTAL:
            trace("horizontal scroll", event.position, "of", event.currentTarget.maxHorizontalScrollPosition);
            break;
        case ScrollBarDirection.VERTICAL:
            trace("vertical scroll", event.position, "of", event.currentTarget.maxVerticalScrollPosition);
            break;
    }
}
securityError Событие  
Тип объекта события: flash.events.SecurityErrorEvent
свойство SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

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

Отправляется, если при загрузке содержимого возникает ошибка системы безопасности.

Константа SecurityErrorEvent.SECURITY_ERROR определяет значение свойства type для объекта события securityError.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetСетевой объект, сообщающий об ошибке безопасности.
textТекст, отображаемый в качестве сообщения об ошибке.
Примеры Как пользоваться примерами
ScrollPaneExample.as

В следующем примере демонстрируется метод, используемый при инициации экземпляра ScrollPane для загрузки нового содержимого, активации перетаскивания и обновления вида в средстве просмотра по отношению ко всему изображению во время перетаскивания.
  1. Разместите изображение test.jpg в том же каталоге, что и свой FLA-файл. Чем оно окажется больше, тем лучше.
  2. Добавьте компонент ScrollPane в библиотеку.
  3. Сохраните этот код под именем ScrollPaneExample.as в том же каталоге, где и FLA-файл.
  4. Присвойте параметру DocumentClass в FLA-файле значение ScrollPaneExample.

Примечание. Изображение должно быть больше компонента ScrollPane (425x380), чтобы они могли взаимодействовать. Это изображение должно также не превышать по ширине и высоте 2880 пикселов из-за ограниченного максимального размера растровых данных, чтобы изображение могло появиться в окне просмотра.

package
{
    import flash.display.Sprite;
    import flash.display.Shape;
    import flash.display.MovieClip;
    import flash.events.*;    
    import flash.geom.Rectangle;
    import flash.display.Bitmap;
    import flash.display.BitmapData;
    import fl.containers.ScrollPane;
    import fl.events.ScrollEvent;

    public class ScrollPaneExample extends Sprite
    {
        private var sampleImagePath:String = "test.jpg";
        private var sp:ScrollPane;
        private var previewPositioner:Sprite;
        private var windowSize:Number = 100;
        private var box:Sprite;
        
        public function ScrollPaneExample() {
            stage.frameRate = 31;
            createScrollPane();
        }
        private function createScrollPane():void {
            sp = new ScrollPane();
            sp.move(10,10);
            sp.setSize(425,380);
            sp.source = sampleImagePath;
            sp.addEventListener(Event.COMPLETE,createPreviewWindow);
            sp.addEventListener(ScrollEvent.SCROLL,repositionPreview);
            sp.scrollDrag = true;
            addChild(sp);            
        }
        private function createPreviewWindow(e:Event):void {
            var previewWindow:Sprite = new Sprite();
            previewWindow.x = 445;
            previewWindow.y = 10;
            previewWindow.graphics.lineStyle(1,0,1);
            previewWindow.graphics.drawRect(0,0,windowSize,windowSize);
            addChild(previewWindow);

            var bitmapData:BitmapData
            try {
                bitmapData = new BitmapData(sp.content.width,sp.content.height);
                bitmapData.draw(sp.content);
                var bitmap:Bitmap = new Bitmap(bitmapData);
                bitmap.width = windowSize;
                bitmap.height = windowSize;
                bitmap.alpha = 0.25
                previewWindow.addChild(bitmap);            
            }
            catch (e:Error) {
                trace(e.toString());
            }
            
            previewPositioner = new Sprite();
            previewPositioner.graphics.beginFill(0xFFFFFF,0.5);
            previewPositioner.graphics.lineStyle(1,0,0.5);
            previewPositioner.graphics.drawRect(0,0,getHorizontalAspect() * windowSize, getVerticalAspect() * windowSize);
            previewPositioner.addEventListener(MouseEvent.MOUSE_DOWN, dragPreviewPositioner);
            previewPositioner.addEventListener(MouseEvent.MOUSE_UP, dropPreviewPositioner);
            previewWindow.addChild(previewPositioner);
        }
        private function dragPreviewPositioner(e:MouseEvent):void {
            var bounds:Rectangle = new Rectangle(0,0,windowSize - Math.floor(previewPositioner.width) + 1,windowSize - Math.floor(previewPositioner.height) + 1);
            previewPositioner.startDrag(false,bounds);
            previewPositioner.addEventListener(MouseEvent.MOUSE_MOVE, repositionScrollPane);
        }
        private function dropPreviewPositioner(e:MouseEvent):void {
            previewPositioner.stopDrag();
            previewPositioner.removeEventListener(MouseEvent.MOUSE_MOVE, repositionScrollPane);
        }
        private function repositionScrollPane(e:MouseEvent):void {
            sp.horizontalScrollPosition = (previewPositioner.x / windowSize) * sp.content.width;
            sp.verticalScrollPosition = (previewPositioner.y / windowSize) * sp.content.height;
        }
        private function repositionPreview(e:ScrollEvent):void {
            previewPositioner.x = (sp.horizontalScrollPosition * windowSize) / sp.content.width;
            previewPositioner.y = (sp.verticalScrollPosition * windowSize) / sp.content.height;
        }
        private function getHorizontalAspect():Number {
            return sp.width / sp.content.width;
        }
        private function getVerticalAspect():Number {
            return sp.height / sp.content.height;
        }
    }
}