Paketflash.events
Klassepublic class ProgressEvent
VererbungProgressEvent Inheritance Event Inheritance Object
Unterklassen VideoProgressEvent

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Flash® Player sendet ProgressEvent-Objekte, wenn ein Ladevorgang begonnen wurde oder ein Socket Daten empfangen hat. Diese Ereignisse werden in der Regel erzeugt, wenn SWF-Dateien, Bilder oder Daten in Flash Player geladen werden. Es gibt zwei Arten von Fortschrittsereignissen: ProgressEvent.PROGRESS und ProgressEvent.SOCKET_DATA.

Beispiele anzeigen

Siehe auch

LoaderInfo-Klasse
Socket-Klasse


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[read-only] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
  bytesLoaded : uint
Die Anzahl der geladenen Elemente oder Bytes zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
ProgressEvent
  bytesTotal : uint
Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang geladen werden.
ProgressEvent
 Inheritedcancelable : Boolean
[read-only] 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
[read-only] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[read-only] Die aktuelle Phase im Ereignisablauf.
Event
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
 Inheritedtarget : Object
[read-only] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[read-only] Der Typ des Ereignisses.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:uint = 0, bytesTotal:uint = 0)
Erstellt ein Ereignisobjekt, das Informationen über progress-Ereignisse enthält.
ProgressEvent
  
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, mit der die toString()-Methode in Ihrer benutzerdefinierten Event-Klasse implementiert wird.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob "preventDefault()" im 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
  
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
 InheritedACTIVATE : String = "activate"
[static] Definiert den Wert der Eigenschaft "type" eines activate-Ereignisobjekts.
Event
 InheritedADDED : String = "added"
[static] Definiert den Wert der Eigenschaft "type" eines added-Ereignisobjekts.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Definiert den Wert der Eigenschaft "type" eines addedToStage-Ereignisobjekts.
Event
 InheritedCANCEL : String = "cancel"
[static] Definiert den Wert der Eigenschaft type eines cancel-Ereignisobjekts.
Event
 InheritedCHANGE : String = "change"
[static] Definiert den Wert der Eigenschaft "type" eines change-Ereignisobjekts.
Event
 InheritedCLOSE : String = "close"
[static] Definiert den Wert der Eigenschaft "type" eines close-Ereignisobjekts.
Event
 InheritedCOMPLETE : String = "complete"
[static] Definiert den Wert der Eigenschaft "type" eines complete-Ereignisobjekts.
Event
 InheritedCONNECT : String = "connect"
[static] Definiert den Wert der Eigenschaft "type" eines connect-Ereignisobjekts.
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] Definiert den Wert der Eigenschaft "type" eines deactivate-Ereignisobjekts.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] Definiert den Wert der Eigenschaft "type" eines enterFrame-Ereignisobjekts.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] Definiert den Wert der Eigenschaft "type" eines fullScreen-Ereignisobjekts.
Event
 InheritedID3 : String = "id3"
[static] Definiert den Wert der Eigenschaft "type" eines id3-Ereignisobjekts.
Event
 InheritedINIT : String = "init"
[static] Definiert den Wert der Eigenschaft "type" eines init-Ereignisobjekts.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Definiert den Wert der Eigenschaft "type" eines mouseLeave-Ereignisobjekts.
Event
 InheritedOPEN : String = "open"
[static] Definiert den Wert der Eigenschaft "type" eines open-Ereignisobjekts.
Event
  PROGRESS : String = "progress"
[static] Definiert den Wert der Eigenschaft "type" eines progress-Ereignisobjekts.
ProgressEvent
 InheritedREMOVED : String = "removed"
[static] Definiert den Wert der Eigenschaft type eines removed-Ereignisobjekts.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Definiert den Wert der Eigenschaft "type" eines removedFromStage-Ereignisobjekts.
Event
 InheritedRENDER : String = "render"
[static] Definiert den Wert der Eigenschaft "type" eines render-Ereignisobjekts.
Event
 InheritedRESIZE : String = "resize"
[static] Definiert den Wert der Eigenschaft type eines resize-Ereignisobjekts.
Event
 InheritedSCROLL : String = "scroll"
[static] Definiert den Wert der Eigenschaft type eines scroll-Ereignisobjekts.
Event
 InheritedSELECT : String = "select"
[static] Definiert den Wert der Eigenschaft type eines select-Ereignisobjekts.
Event
  SOCKET_DATA : String = "socketData"
[static] Definiert den Wert der Eigenschaft "type" eines socketData-Ereignisobjekts.
ProgressEvent
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Definiert den Wert der Eigenschaft "type" eines soundComplete-Ereignisobjekts.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Definiert den Wert der Eigenschaft "type" eines tabChildrenChange-Ereignisobjekts.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Definiert den Wert der Eigenschaft type eines tabEnabledChange-Ereignisobjekts.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Definiert den Wert der Eigenschaft "type" eines tabIndexChange-Ereignisobjekts.
Event
 InheritedUNLOAD : String = "unload"
[static] Definiert den Wert der Eigenschaft "type" eines unload-Ereignisobjekts.
Event
Eigenschaftsdetail
bytesLoadedEigenschaft
bytesLoaded:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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


Implementierung
    public function get bytesLoaded():uint
    public function set bytesLoaded(value:uint):void
bytesTotalEigenschaft 
bytesTotal:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang geladen werden.


Implementierung
    public function get bytesTotal():uint
    public function set bytesTotal(value:uint):void
Konstruktordetail
ProgressEvent()Konstruktor
public function ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:uint = 0, bytesTotal:uint = 0)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Parameter
type:String — Der Ereignistyp. Folgende Werte sind möglich: ProgressEvent.PROGRESS und ProgressEvent.SOCKET_DATA.
 
bubbles:Boolean (default = false) — Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt.
 
cancelable:Boolean (default = false) — Legt fest, ob das Ereignisobjekt abgebrochen werden kann.
 
bytesLoaded:uint (default = 0) — Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
 
bytesTotal:uint (default = 0) — Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang geladen werden.
Methodendetail
clone()Methode
public override function clone():Event

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 
public override function toString():String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.
Konstantendetail
PROGRESSKonstante
public static const PROGRESS:String = "progress"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.
targetDer Protokollierungsstatus des Netzwerkobjekts.

Siehe auch

SOCKET_DATAKonstante 
public static const SOCKET_DATA:String = "socketData"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 Protokollierungsstatus des Socketobjekts.

Siehe auch

Beispiele Verwendung von Beispielen
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:


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




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/events/ProgressEvent.html