Пакетfl.controls
Классpublic class ProgressBar
НаследованиеProgressBar Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

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

Компонент ProgressBar отображает ход загрузки содержимого. ProgressBar обычно используется для показа состояния изображений, а также частей приложений во время их загрузки. Процесс загрузки может быть как определенным, так и неопределенным. Определенный индикатор выполнения является линейным представлением хода выполнения задачи, которое используется, когда объем загружаемого содержимого известен. Неопределенный индикатор выполнения имеет штриховую заливку и источник загрузки неизвестного размера.

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

См. также

ProgressBarDirection
ProgressBarMode


Общедоступные свойства
 СвойствоОпределено
 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
  direction : String
Указывает направление заполнения индикатора выполнения.
ProgressBar
 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
  indeterminate : Boolean
Определяет или задает значение, указывающее, какой вид заполнения используется индикатором выполнения, а также известен ли источник загрузки.
ProgressBar
 InheritedloaderInfo : LoaderInfo
[только для чтения] Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект.
DisplayObject
 Inheritedmask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask.
DisplayObject
  maximum : Number
Определяет или задает максимальное значение для индикатора выполнения, если свойство ProgressBar.mode имеет значение ProgressBarMode.MANUAL.
ProgressBar
  minimum : Number
Определяет или задает минимальное значение для индикатора выполнения, если свойство ProgressBar.mode имеет значение ProgressBarMode.MANUAL.
ProgressBar
  mode : String
Определяет или задает метод, используемый для обновления индикатора выполнения.
ProgressBar
 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
  percentComplete : Number
[только для чтения] Определяет число, показывающее объем загруженной части содержимого (от 0 до 100 %).
ProgressBar
 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
 InheritedscrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта.
DisplayObject
 InheritedsoundTransform : SoundTransform
Управляет звуком в данном спрайте.
Sprite
  source : Object
Определяет или задает ссылку на загружаемое содержимое, ход выполнения операции загрузки которого отображает компонент ProgressBar.
ProgressBar
 Inheritedstage : Stage
[только для чтения] Класс Stage экранного объекта.
DisplayObject
 InheritedtabChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью клавиши Tab.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Определяет, включен ли этот объект в последовательность перехода с помощью клавиши Tab.
InteractiveObject
 InheritedtabIndex : int
Задает последовательность перехода между объектами в SWF-файле.
InteractiveObject
 InheritedtextSnapshot : TextSnapshot
[только для чтения] Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inheritedtransform : Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта.
DisplayObject
 InheriteduseHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться указатель "рука" при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true.
Sprite
  value : Number
Определяет или задает значение, указывающее текущее состояние операции загрузки.
ProgressBar
 Inheritedversion : String = "3.0.0.15"
Номер версии компонентов.
UIComponent
 Inheritedvisible : Boolean
Определяет или задает значение, указывающее, видим ли текущий экземпляр компонента.
UIComponent
 Inheritedwidth : Number
Определяет или задает ширину компонента (в пикселах).
UIComponent
 Inheritedx : Number
Определяет или задает координату, представляющую положение компонента по оси X в пределах родительского контейнера.
UIComponent
 Inheritedy : Number
Определяет или задает координату, представляющую положение компонента по оси Y в пределах родительского контейнера.
UIComponent
 Inheritedz : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера.
DisplayObject
Общедоступные методы
 МетодОпределено
  
Создает новый экземпляр компонента ProgressBar.
ProgressBar
 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
DisplayObject
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace.
DisplayObject
 Inherited
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса.
DisplayObjectContainer
 Inherited
Возвращает экземпляр дочернего экранного объекта с заданным именем.
DisplayObjectContainer
 Inherited
Возвращает позицию индекса для дочернего экземпляра DisplayObject.
DisplayObjectContainer
 Inherited
DisplayObject
 Inherited
Возвращает объект, который в настоящее время имеет фокус.
UIComponent
 Inherited
Возвращает массив объектов, расположенных ниже заданной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур.
DisplayObject
 Inherited
Возвращает свойство style, установленное в последовательности для поиска стилей компонента.
UIComponent
  
[статические] Возвращает карту стилей по умолчанию для текущего компонента.
ProgressBar
 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
 Inherited
Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные).
DisplayObject
 Inherited
[статические] Объединяет стили из нескольких классов в одном объекте.
UIComponent
 Inherited
Перемещает компонент в указанное положение в пределах его родительского компонента.
UIComponent
 Inherited
DisplayObject
 Inherited
DisplayObject
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Удаляет заданный дочерний объект DisplayObject из списка потомков экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Удаляет дочерний DisplayObject из заданной позиции индекса в списке потомков DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
  
Сбрасывает значения индикатора выполнения для начала новой операции загрузки.
ProgressBar
 Inherited
Изменяет положение существующего потомка в DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Задает фокус на этот компонент.
UIComponent
  
setProgress(value:Number, maximum:Number):void
Задает отображение хода выполнения через состояние панели при работе в ручном режиме.
ProgressBar
 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
 Inherited
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его при необходимости.
UIComponent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
Защищенные методы
 МетодОпределено
 Inherited
Возвращает указанный стиль для компонента, учитывая все стили, заданные на глобальном уровне, уровне компонентов и уровне экземпляров.
UIComponent
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
 InheritedОтправляется, когда экранный объект добавляется в список отображения.DisplayObject
 InheritedОтправляется, когда экранный объект добавляется к списку отображения в рабочей области, либо непосредственно, либо путем добавления поддерева, содержащего экранный объект.DisplayObject
 InheritedОтправляется, когда пользователь выбирает команду "Удалить" в контекстном меню текста.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject.InteractiveObject
  Отправляется по завершении операции загрузки.ProgressBar
 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
 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
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вставить", или выбирает команду "Вставить" из контекстного меню.InteractiveObject
  Отправляется, когда содержимое загружается в режиме событий или в режиме запросов.ProgressBar
 InheritedОтправляется перед удалением экранного объекта из списка отображения.DisplayObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения, либо непосредственно, либо путем удаления поддерева, содержащего экранный объект.DisplayObject
 Inherited[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения.DisplayObject
 InheritedОтправляется при изменении размеров компонента.UIComponent
 InheritedОтправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Выделить все", или выбирает команду "Выделить все" из контекстного меню.InteractiveObject
 InheritedОтправляется, когда невидимый компонент становится видимым.UIComponent
 InheritedОтправляется, когда изменяется значение свойства tabChildren объекта.InteractiveObject
 InheritedОтправляется при изменении флага tabEnabled объекта.InteractiveObject
 InheritedОтправляется, когда изменяется значение свойства tabIndex объекта.InteractiveObject
Стили
 Стиль Описание Определено
  
barPadding
Тип: Number Формат: Length
Ширина заполнителя, который отделяет индикатор выполнения от дорожки, в пикселах. Значение по умолчанию 0.
ProgressBar
  
barSkin
Тип: Class
Имя класса, используемого в качестве определенного индикатора выполнения. Значение по умолчанию ProgressBar_barSkin.
ProgressBar
 InheritedТип: flash.text.TextFormat
Объект TextFormat, который используется для визуализации метки компонента, когда кнопка отключена.
UIComponent
 InheritedТип: Number Формат: Length
Заполнитель, отделяющий внешние границы компонента от внешних краев индикатора фокуса, в пикселах.
UIComponent
 InheritedТип: Class
Обложка, используемая для показа индикаторов фокуса.
UIComponent
  
icon
Тип: Class
Имя класса, применяемого в качестве значка по умолчанию. Выбор любого другого стиля значка переопределяет этот параметр. Значение по умолчанию null.
ProgressBar
  
indeterminateBar
Тип: Class
Класс, используемый как средство визуализации для анимации неопределенного индикатора. Это расширенный стиль. Значение по умолчанию fl.controls.progressBarClasses.IndeterminateBar.
ProgressBar
  
indeterminateSkin
Тип: Class
Имя класса, используемого в качестве неопределенного индикатора выполнения. Оно передается средству визуализации неопределенного индикатора выполнения, который задан стилем indeterminateBar. Значение по умолчанию ProgressBar_indeterminateSkin.
ProgressBar
 InheritedТип: flash.text.TextFormat
Объект TextFormat, используемый для визуализации метки компонента.
UIComponent
  
trackSkin
Тип: Class
Имя класса, используемого в качестве дорожки индикатора выполнения. Значение по умолчанию ProgressBar_trackSkin.
ProgressBar
Сведения о свойстве
directionсвойство
direction:String  [чтение и запись]

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

Указывает направление заполнения индикатора выполнения. Значение ProgressBarDirection.RIGHT указывает на то, что индикатор выполнения заполняется слева направо. Значение ProgressBarDirection.LEFT указывает на то, что индикатор выполнения заполняется справа налево.

Значение по умолчанию ProgressBarDirection.RIGHT


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

См. также


Пример
В следующем примере показана разница между индикатором выполнения, загружаемым слева и индикатором выполнения, загружаемым справа. Замените testPath большим файлом, чтобы выполнить локальную проверку:
 
import fl.controls.ProgressBar;
import fl.controls.ProgressBarDirection;

var testPath:String = "largeVideo.flv";
var loader:URLLoader = new URLLoader();
loader.load(new URLRequest(testPath));

var leftProgressBar:ProgressBar = new ProgressBar();
leftProgressBar.move(10,10);
leftProgressBar.direction = ProgressBarDirection.LEFT;
leftProgressBar.source = loader;
addChild(leftProgressBar);

var rightProgressBar:ProgressBar = new ProgressBar();
rightProgressBar.move(10,40);
rightProgressBar.source = loader;
rightProgressBar.direction = ProgressBarDirection.RIGHT;
addChild(rightProgressBar);
indeterminateсвойство 
indeterminate:Boolean  [чтение и запись]

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

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

Это свойство можно задать только при выборе режима индикатора выполнения ProgressBarMode.MANUAL.

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


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

См. также

maximumсвойство 
maximum:Number  [чтение и запись]

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

Определяет или задает максимальное значение для индикатора выполнения, если свойство ProgressBar.mode имеет значение ProgressBarMode.MANUAL.

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


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

См. также

minimumсвойство 
minimum:Number  [чтение и запись]

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

Определяет или задает минимальное значение для индикатора выполнения, если свойство ProgressBar.mode имеет значение ProgressBarMode.MANUAL.

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


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

См. также

modeсвойство 
mode:String  [чтение и запись]

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

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

Этому свойству можно присвоить следующие значения:

Наиболее часто встречаются режим событий и режим запросов. В режиме событий свойство source указывает на загружаемое содержимое, которое генерирует события progress и complete; в этом режиме необходимо использовать объект UILoader. В режиме запросов свойство source указывает на загружаемое содержимое (пользовательский класс, который предоставляет свойства bytesLoaded и bytesTotal). Любой объект, который предоставляет эти свойства, может использоваться в качестве источника в режиме запросов.

Компонентом ProgressBar можно также воспользоваться в ручном режиме, установив вручную свойства maximum и minimum и выполнив вызовы метода ProgressBar.setProgress().

Значение по умолчанию ProgressBarMode.EVENT


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

См. также

percentCompleteсвойство 
percentComplete:Number  [только для чтения]

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

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

Чтобы изменить процентное значение, воспользуйтесь методом setProgress().

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


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

См. также


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

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

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.indeterminate = false;
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.maximum = 256;
myProgressBar.setSize(320, 16);
myProgressBar.move(10, 10)
addChild(myProgressBar);

var myLabel:Label = new Label();
myLabel.text = "";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myProgressBar.x, myProgressBar.y + myProgressBar.height);
addChild(myLabel);

var t:Timer = new Timer(150);
t.addEventListener(TimerEvent.TIMER, timerHandler);
t.start();

function timerHandler(event:TimerEvent):void {
    myProgressBar.setProgress(myProgressBar.value + 1, myProgressBar.maximum);
    if (myProgressBar.percentComplete == 100) {
        myProgressBar.setProgress(0, myProgressBar.maximum);
    }
    myLabel.text = int(myProgressBar.value) + " of " + int(myProgressBar.maximum) + " (" + int(myProgressBar.percentComplete) + "%)";
}
В следующем примере показано, как отслеживается ход выполнения загрузки с помощью свойства percentLoaded. Переменной dataPath необходимо сначала присвоить удаленный файл:
import fl.controls.ProgressBar;
import fl.controls.Label

var dataPath:String = "test.txt";
var loader:URLLoader = new URLLoader();
loader.load(new URLRequest(dataPath));

var progressReport:Label = new Label();
progressReport.move(10,30);
progressReport.autoSize = TextFieldAutoSize.LEFT;
addChild(progressReport);

var pb:ProgressBar = new ProgressBar();
pb.move(10,10);
pb.source = loader;
pb.addEventListener(ProgressEvent.PROGRESS,updateProgressReport);
addChild(pb);

function updateProgressReport(e:ProgressEvent):void {
    progressReport.text = Math.round(pb.percentComplete) + "% Loaded";
}
sourceсвойство 
source:Object  [чтение и запись]

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

Определяет или задает ссылку на загружаемое содержимое, ход выполнения операции загрузки которого отображает компонент ProgressBar. Как правило, этому свойству назначается компонент UILoader.

Используйте это свойство только в режиме событий и в режиме запросов.

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


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

Пример
В следующем примере показано, как связать индикатор выполнения с загрузчиком путем установки свойства source. Чтобы показать на индикаторе загрузки ход выполнения загрузки, необходимо сначала задать для переменной dataPath удаленный файл:
import fl.controls.ProgressBar;

var dataPath:String = "test.txt";
var loader:URLLoader = new URLLoader();
loader.load(new URLRequest(dataPath));

var pb:ProgressBar = new ProgressBar();
pb.source = loader;
addChild(pb);
В следующем примере для свойства source индикатора выполнения выбирается панель прокрутки:

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

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
myScrollPane.source = "http://www.helpexamples.com/flash/images/image3.jpg";
addChild(myScrollPane);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.width = myScrollPane.width;
myProgressBar.move(myScrollPane.x, myScrollPane.y - myProgressBar.height);
myProgressBar.source = myScrollPane;
addChild(myProgressBar);
valueсвойство 
value:Number  [чтение и запись]

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

Определяет или задает значение, указывающее текущее состояние операции загрузки. Это значение представляет собой число в диапазон от значения minimum до значения maximum.

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


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

См. также

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

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

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

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

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 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;
}
reset()метод 
public function reset():void

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

Сбрасывает значения индикатора выполнения для начала новой операции загрузки.

setProgress()метод 
public function setProgress(value:Number, maximum:Number):void

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

Задает отображение хода выполнения через состояние панели при работе в ручном режиме. Аргументу value присваивается свойство value, а аргументу maximum присваивается свойство maximum. Свойство minimum остается неизменным.

Параметры

value:Number — Значение, описывающее выполненную часть задачи.
 
maximum:Number — Максимальное значение индикатора выполнения.

См. также

Сведения о событии
complete Событие
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.COMPLETE

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

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

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

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

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

Пример

В следующем примере с помощью компонента UILoader загружается внешнее изображение. После завершения загрузки компоненты ProgressBar и Label скрываются.

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

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

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.source = url;
myUILoader.move(10, 10);
myUILoader.scaleContent = false;
myUILoader.load();

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.source = myUILoader;
myProgressBar.move(myUILoader.x, myUILoader.y);
myProgressBar.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myProgressBar.addEventListener(Event.COMPLETE, completeHandler);
addChild(myProgressBar)

var myLabel:Label = new Label();
myLabel.text = "xx";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myProgressBar.x, myProgressBar.y + myProgressBar.height);
addChild(myLabel);

function progressHandler(event:ProgressEvent):void {
    trace("progress:", event.bytesLoaded, event.bytesTotal, int(event.currentTarget.percentComplete) + "%");
    myLabel.text = event.bytesLoaded + " of " + event.bytesTotal + " bytes loaded.";
}

function completeHandler(event:Event):void {
    trace("complete:");
    myProgressBar.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myProgressBar.removeEventListener(Event.COMPLETE, completeHandler);
    removeChild(myProgressBar);
    removeChild(myLabel);
    
    addChild(myUILoader);
}
progress Событие  
Тип объекта события: flash.events.ProgressEvent
свойство ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

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

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

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

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

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

Пример

В следующем примере с помощью компонента UILoader загружается внешнее изображение. После завершения загрузки компоненты ProgressBar и Label скрываются.

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

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

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.source = url;
myUILoader.move(10, 10);
myUILoader.scaleContent = false;
myUILoader.load();

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.source = myUILoader;
myProgressBar.move(myUILoader.x, myUILoader.y);
myProgressBar.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myProgressBar.addEventListener(Event.COMPLETE, completeHandler);
addChild(myProgressBar)

var myLabel:Label = new Label();
myLabel.text = "xx";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myProgressBar.x, myProgressBar.y + myProgressBar.height);
addChild(myLabel);

function progressHandler(event:ProgressEvent):void {
    trace("progress:", event.bytesLoaded, event.bytesTotal, int(event.currentTarget.percentComplete) + "%");
    myLabel.text = event.bytesLoaded + " of " + event.bytesTotal + " bytes loaded.";
}

function completeHandler(event:Event):void {
    trace("complete:");
    myProgressBar.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myProgressBar.removeEventListener(Event.COMPLETE, completeHandler);
    removeChild(myProgressBar);
    removeChild(myLabel);
    
    addChild(myUILoader);
}

См. также

Примеры Как пользоваться примерами
ProgressBarExample.as

В этом примере показано, как выполняется приращение ProgressBar вручную.
  1. Добавьте компоненты ProgressBar, Label и Button в свою библиотеку.
  2. Сохраните этот код под именем ProgressBarExample.as в том же каталоге, где и FLA-файл.
  3. Присвойте параметру DocumentClass в FLA-файле значение ProgressBarExample.
package
{
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import fl.controls.ProgressBar;
    import fl.controls.Button;
    
    public class ProgressBarExample extends Sprite
    {
        private var j:uint;
        private var pb:ProgressBar;
        private var fakeProgressCount:uint;
        
        public function ProgressBarExample() {
            setupProgressBar();    
            setupButton();
        }
        private function advancePreloader(e:MouseEvent):void {
            fakeProgressCount = fakeProgressCount == 100 ? 0 : fakeProgressCount + 10;
            pb.setProgress(fakeProgressCount, 100);
        }
        private function setupButton():void {
            var b:Button = new Button();
            b.move(10,30);
            b.setSize(120,20);
            b.label = "Increment Progress";
            b.addEventListener(MouseEvent.CLICK,advancePreloader);
            addChild(b);
        }
        private function setupProgressBar():void {
            fakeProgressCount = 0;
            pb = new ProgressBar();
            pb.move(10,10);
            addChild(pb);
        }
    }
}