ProgressEvent  - AS3

Het aantal items of bytes dat wordt geladen wanneer de listener de gebeurtenis verwerkt.

Het totale aantal items of bytes dat wordt geladen wanneer het laadproces is voltooid. Als de voortgangsgebeurtenis is verzonden naar of is gekoppeld aan een Socket-object, is bytesTotal altijd 0, tenzij in de parameter bytesTotal van de constructor een waarde is opgegeven. Het aantal bytes dat werkelijk heen of terug is verzonden, is niet ingesteld, en is afhankelijk van de toepassingsontwikkelaar.

Maakt een Event-object dat informatie bevat over gebeurtenissen Progress. Gebeurtenisobjecten worden als parameters aan gebeurtenislisteners doorgegeven.

Maakt een kopie van het object ProgressEvent en stelt de waarde van elke eigenschap in zodat deze overeenkomt met die van het origineel.

Retourneert een tekenreeks die alle eigenschappen van het object ProgressEvent bevat. De tekenreeks heeft de volgende indeling:

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

Definieert de waarde van de eigenschap type van een gebeurtenisobject progress.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een gebeurtenisobject socketData.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een standardErrorData-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een standardInputProgress-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een standardOutputData-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

1. De eigenschappen downloadURL en fileName worden gemaakt, die de locatie en naam van het te downloaden bestand aangeven.
2. In de constructor ProgressEventExample wordt een nieuw object FileReference gemaakt met de naam file en vervolgens doorgegeven aan de methode configureListeners().
3. De eigenschappen downloadURL en fileName worden vervolgens doorgegeven aan file.download(), die u vraagt de locatie van het te downloaden bestand op te geven.
4. De methode configureListeners() voegt zeven gebeurtenislisteners en hun abonneemethoden toe:
   1. cancel / cancelHandler() wordt verzonden wanneer het downloaden wordt geannuleerd.
   2. complete / complereHandler() wordt verzonden wanneer het downloaden is voltooid.
   3. ioError / ioErrorHandler() wordt verzonden wanneer het te downloaden bestand niet beschikbaar of toegankelijk is.
   4. open / openHandler() wordt verzonden wanneer het downloaden is gestart.
   5. progress / progressHandler() wordt verzonden wanneer het downloaden begint en wanneer het wordt beëindigd.
   6. securityError / securityErrorHandler wordt verzonden wanneer de lokale afspeelbeveiliging niet overeenkomt met het type gegevenstoegang voor het te downloaden bestand (lokaal tegenover netwerk); zie de opmerkingen hieronder.
   7. select / selectHandler() wordt verzonden wanneer het downloaden is gestart.

Opmerkingen:

• U moet het SWF-bestand compileren met Lokale afspeelbeveiliging ingesteld op Alleen netwerkbestanden benaderen.
• In dit voorbeeld is een bestand SomeFile.pdf vereist.
• Hoewel dit voorbeeld gebruikmaakt van alle gebeurtenissen waar het object FileReference over beschikt, is in de meeste gevallen alleen een subset nodig.

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);
        }
    }
}