ProgressEvent  - AS3

Число элементов или байтов, загруженных на момент обработки события прослушивателем.

Общее число элементов или байтов, которые будут получены в случае успешного завершения загрузки. Если событие прогресса отправляется/присоединяется к объекту Socket, свойство bytesTotal будет всегда иметь значение 0, если значение не задано в параметре bytesTotal конструктора. Фактическое число байт, отправляемых в обоих направлениях, не задано и определяется разработчиком приложения.

Создает объект Event, содержащий данные о событиях в ходе работы. Объекты Event передаются прослушивателям событий в качестве параметров.

Создает копию объекта ProgressEvent и задает значение каждого свойства, совпадающее с оригиналом.

Возвращает строку, содержащую все свойства объекта ProgressEvent. Строка имеет следующий формат:

[ProgressEvent type=value bubbles=value cancelable=value bytesLoaded=value bytesTotal=value]

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

Это событие имеет следующие свойства:

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

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

Это событие имеет следующие свойства:

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

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

Это событие имеет следующие свойства:

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

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

Это событие имеет следующие свойства:

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

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

Это событие имеет следующие свойства:

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

1. Создаются свойства downloadURL и fileName, указывающие местоположение и имя загружаемого файла.
2. В конструкторе ProgressEventExample создается новый объект FileReference с именем file и передается методу configureListeners().
3. Затем свойства downloadURL и fileName передаются методу file.download(), который указывает местоположение для загрузки файла.
4. Метод configureListeners() добавляет семь прослушивателей событий со связанными методами подписчиков:
   1. cancel/cancelHandler() отправляется в случае отмены загрузки;
   2. complete/complereHandler() отправляется по окончании загрузки файла;
   3. ioError/ioErrorHandler() отправляется, если загружаемый файл недоступен.
   4. open/openHandler() отправляется после начала операции загрузки;
   5. progress/progressHandler() отправляется два раза: когда процесс загрузки начинается и когда заканчивается;
   6. securityError/securityErrorHandler отправляется, если параметр безопасности локального воспроизведения не соответствует типу доступа к данным для загружаемого файла (локальный/сетевой); см. примечания ниже;
   7. select/selectHandler() отправляется, когда выбирается загружаемый файл.

Примечания.

• SWF-файл требуется откомпилировать с установленным для параметра «Безопасность локального воспроизведения» режимом «Доступ только к сетевым файлам».
• Для реализации данного примера требуется файл с именем SomeFile.pdf.
• Хотя в этом примере используются все события, доступные для объекта FileReference, в большинстве случаев требуется только та или иная подгруппа..

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class ProgressEventExample extends Sprite {
        private var downloadURL:String = "http://www.[yourDomain].com/SomeFile.pdf";
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function ProgressEventExample() {
            var request:URLRequest = new URLRequest(downloadURL);
            file = new FileReference();
            configureListeners(file);
            file.download(request, fileName);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.CANCEL, cancelHandler);
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(Event.SELECT, selectHandler);
        }

        private function cancelHandler(event:Event):void {
            trace("cancelHandler: " + event);
        }

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

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + downloadURL);
        }
    }
}