ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.events 

ProgressEvent  - AS3

Paketflash.events
Klassepublic class ProgressEvent
VererbungProgressEvent Inheritance Event Inheritance Object
Unterklassen ModuleEvent, ResourceEvent, RSLEvent, StyleEvent, VideoProgressEvent

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein ProgressEvent-Objekt wird ausgelöst, wenn eine Ladevorgang gestartet wurde oder ein Socket Daten empfangen hat. Diese Ereignisse werden in der Regel erzeugt, wenn SWF-Dateien, Bilder oder Daten in eine Anwendung geladen werden. Es gibt zwei Arten von Fortschrittsereignissen: ProgressEvent.PROGRESS und ProgressEvent.SOCKET_DATA. Zusätzlich werden in AIR ProgressEvent-Objekte abgesetzt, wenn Daten unter Verwendung der NativeProcess-Klasse von oder zu einem untergeordneten Prozess gesendet werden.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
  bytesLoaded : Number
Die Anzahl der geladenen Elemente oder Bytes zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
ProgressEvent
  bytesTotal : Number
Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang geladen werden.
ProgressEvent
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:Number = 0, bytesTotal:Number = 0)
Erstellt ein Ereignisobjekt, das Informationen über progress-Ereignisse enthält.
ProgressEvent
  
[override] Erstellt eine Kopie des ProgressEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
ProgressEvent
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
[override] Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ProgressEvent-Objekts enthält.
ProgressEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  PROGRESS : String = "progress"
[statisch] Definiert den Wert der Eigenschaft „type“ eines progress-Ereignisobjekts.
ProgressEvent
  SOCKET_DATA : String = "socketData"
[statisch] Definiert den Wert der Eigenschaft „type“ eines socketData-Ereignisobjekts.
ProgressEvent
  STANDARD_ERROR_DATA : String = "standardErrorData"
[statisch] Definiert den Wert der type-Eigenschaft eines standardErrorData-Ereignisobjekts.
ProgressEvent
  STANDARD_INPUT_PROGRESS : String = "standardInputProgress"
[statisch] Definiert den Wert der type-Eigenschaft eines standardInputProgress-Ereignisobjekts.
ProgressEvent
  STANDARD_OUTPUT_DATA : String = "standardOutputData"
[statisch] Definiert den Wert der type-Eigenschaft eines standardOutputData-Ereignisobjekts.
ProgressEvent
Eigenschaftendetails

bytesLoaded

Eigenschaft
bytesLoaded:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die Anzahl der geladenen Elemente oder Bytes zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.



Implementierung
    public function get bytesLoaded():Number
    public function set bytesLoaded(value:Number):void

bytesTotal

Eigenschaft 
bytesTotal:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang geladen werden. Wenn das Fortschrittsereignis ausgelöst oder einem Socket-Objekt hinzugefügt wird, ist der Wert von bytesTotal immer 0, falls nicht im bytesTotal-Parameter des Konstruktors ein Wert angegeben wird. Die tatsächliche Anzahl der Byte, die zurück order vorwärts gesendet werden, wird nicht festgelegt und ist Sache des Anwendungsentwicklers.



Implementierung
    public function get bytesTotal():Number
    public function set bytesTotal(value:Number):void
Konstruktordetails

ProgressEvent

()Konstruktor
public function ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:Number = 0, bytesTotal:Number = 0)

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt ein Ereignisobjekt, das Informationen über progress-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.

Parameter
type:String — Der Ereignistyp. Mögliche Werte sind:ProgressEvent.PROGRESS, ProgressEvent.SOCKET_DATA, ProgressEvent.STANDARD_ERROR_DATA, ProgressEvent.STANDARD_INPUT_PROGRESS und ProgressEvent.STANDARD_OUTPUT_DATA.
 
bubbles:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt.
 
cancelable:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann.
 
bytesLoaded:Number (default = 0) — Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
 
bytesTotal:Number (default = 0) — Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang geladen werden.
Methodendetails

clone

()Methode
override public function clone():Event

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt eine Kopie des ProgressEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.

Rückgabewerte
Event — Ein neues ProgressEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.

toString

()Methode 
override public function toString():String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt eine Zeichenfolge zurück, die alle Eigenschaften des ProgressEvent-Objekts enthält. Der String liegt im folgenden Format vor:

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

Rückgabewerte
String — Eine Zeichenfolge, die alle Eigenschaften des ProgressEvent-Objekts enthält.
Konstantendetails

PROGRESS

Konstante
public static const PROGRESS:String = "progress"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Definiert den Wert der Eigenschaft type eines progress-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
bytesLoadedDie Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
bytesTotalDie Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang schließlich geladen werden.
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Objekt, dessen Fortschritt protokolliert wird.

Verwandte API-Elemente

SOCKET_DATA

Konstante 
public static const SOCKET_DATA:String = "socketData"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Definiert den Wert der Eigenschaft type eines socketData-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, das das Ereignis aktiv verarbeitet.
bytesLoadedDie Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
bytesTotal0. Diese Eigenschaft wird von socketData-Ereignisobjekten nicht verwendet.
targetDer Socket, dessen Fortschritt protokolliert wird.

Verwandte API-Elemente

STANDARD_ERROR_DATA

Konstante 
public static const STANDARD_ERROR_DATA:String = "standardErrorData"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2, Flash Lite 4

Definiert den Wert der type-Eigenschaft eines standardErrorData-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, das das Ereignis aktiv verarbeitet.
bytesLoadedDie Anzahl der Bytes der Fehlerdaten, die von NativeProcessObject.error aufgrund dieses Ereignisses gepuffert wurden.
bytesTotal0; diese Eigenschaft wird von standardErrorData-Ereignisobjekten nicht verwendet.
targetDas NativeProcess-Objekt, das die Fehlerdaten meldet.

Verwandte API-Elemente

STANDARD_INPUT_PROGRESS

Konstante 
public static const STANDARD_INPUT_PROGRESS:String = "standardInputProgress"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2, Flash Lite 4

Definiert den Wert der type-Eigenschaft eines standardInputProgress-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, das das Ereignis aktiv verarbeitet.
bytesLoadedDie Anzahl der Bytes der Fehlerdaten, die von NativeProcessObject.error aufgrund dieses Ereignisses gepuffert wurden.
bytesTotal0; diese Eigenschaft wird von standardInputProgress-Ereignisobjekten nicht verwendet.
targetDas NativeProcess-Objekt, das die Fehlerdaten meldet.

Verwandte API-Elemente

STANDARD_OUTPUT_DATA

Konstante 
public static const STANDARD_OUTPUT_DATA:String = "standardOutputData"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2, Flash Lite 4

Definiert den Wert der type-Eigenschaft eines standardOutputData-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, das das Ereignis aktiv verarbeitet.
bytesLoadedDie Anzahl der Bytes der Ausgabedaten, die von NativeProcessObject.output aufgrund dieses Ereignisses gepuffert wurden.
bytesTotal0; diese Eigenschaft wird von standardOutputData-Ereignisobjekten nicht verwendet.
targetDas NativeProcess-Objekt, das die Ausgabedaten meldet.

Verwandte API-Elemente

ProgressEventExample.as

Im folgenden Beispiel wird anhand der Klasse ProgressEventExample gezeigt, wie verschiedene Ereignis-Listener beim Herunterladen einer Datei verwendet werden. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Die Eigenschaften downloadURL und fileName werden mit dem Speicherort und dem Namen der Download-Datei erstellt.
  2. Im Konstruktor ProgressEventExample wird ein neues FileReference-Objekt mit dem Namen file erstellt, das dann an die configureListeners()-Methode übergeben wird.
  3. Die Eigenschaften downloadURL und fileName werden an file.download() übergeben. Diese Methode ermittelt dann den Speicherort für den Download der Datei.
  4. Die configureListeners()-Methode fügt sieben Ereignis-Listener und die verknüpften Abonnentenmethoden hinzu:
    1. cancel/cancelHandler() wird ausgelöst, wenn das Herunterladen der Datei abgebrochen wird.
    2. complete/complereHandler() wird ausgelöst, wenn das Herunterladen der Dateien abgeschlossen ist.
    3. ioError/ioErrorHandler() wird ausgelöst, wenn die Download-Datei nicht verfügbar oder unzugänglich ist.
    4. open/openHandler()wird nach Beginn des Download-Vorgangs ausgelöst.
    5. progress/progressHandler() wird beim Beginn und beim Ende des Download-Vorgangs ausgelöst.
    6. securityError/securityErrorHandler wird ausgelöst, wenn die lokalen Sicherheitseinstellungen für die Wiedergabe nicht mit der Art des Datenzugriffs für die Download-Datei übereinstimmen (lokaler Zugriff bzw. Netzwerkzugriff). Siehe Hinweise unten.
    7. select/selectHandler() wird bei Auswahl des Download-Objekts ausgelöst.

Hinweise:

  • Für die Kompilierung der SWF-Datei müssen Sie die Option „Sicherheit bei lokaler Wiedergabe“ auf „Nur auf Netzwerk zugreifen“ einstellen.
  • Bei diesem Beispiel ist die Datei SomeFile.pdf erforderlich.
  • Obwohl in diesem Beispiel alle verfügbaren Ereignisse des FileReference-Objekts verwendet werden, ist in den meisten Situationen nur ein Teil davon erforderlich.

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




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.