Paket | flash.events |
Klasse | public class ProgressEvent |
Vererbung | ProgressEvent Event Object |
Unterklassen | ModuleEvent, ResourceEvent, RSLEvent, StyleEvent, VideoProgressEvent |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
bubbles : 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 | ||
cancelable : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. | Event | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
currentTarget : Object [schreibgeschützt]
Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. | Event | ||
eventPhase : uint [schreibgeschützt]
Die aktuelle Phase im Ereignisablauf. | Event | ||
target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | ||
type : String [schreibgeschützt]
Der Ereignistyp. | Event |
Methode | Definiert 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 | ||
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
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 | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
Konstante | Definiert 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 |
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
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.
Parametertype: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.
|
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ückgabewerteEvent — 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]
String — Eine Zeichenfolge, die alle Eigenschaften des ProgressEvent -Objekts enthält.
|
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:
Eigenschaft | Wert |
---|---|
bubbles | false |
bytesLoaded | Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet. |
bytesTotal | Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang schließlich geladen werden. |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das 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:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, das das Ereignis aktiv verarbeitet. |
bytesLoaded | Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet. |
bytesTotal | 0. Diese Eigenschaft wird von socketData -Ereignisobjekten nicht verwendet. |
target | Der 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:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, das das Ereignis aktiv verarbeitet. |
bytesLoaded | Die Anzahl der Bytes der Fehlerdaten, die von NativeProcessObject.error aufgrund dieses Ereignisses gepuffert wurden. |
bytesTotal | 0; diese Eigenschaft wird von standardErrorData -Ereignisobjekten nicht verwendet. |
target | Das 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:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, das das Ereignis aktiv verarbeitet. |
bytesLoaded | Die Anzahl der Bytes der Fehlerdaten, die von NativeProcessObject.error aufgrund dieses Ereignisses gepuffert wurden. |
bytesTotal | 0; diese Eigenschaft wird von standardInputProgress -Ereignisobjekten nicht verwendet. |
target | Das 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:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, das das Ereignis aktiv verarbeitet. |
bytesLoaded | Die Anzahl der Bytes der Ausgabedaten, die von NativeProcessObject.output aufgrund dieses Ereignisses gepuffert wurden. |
bytesTotal | 0; diese Eigenschaft wird von standardOutputData -Ereignisobjekten nicht verwendet. |
target | Das NativeProcess-Objekt, das die Ausgabedaten meldet. |
Verwandte API-Elemente
ProgressEventExample
gezeigt, wie verschiedene Ereignis-Listener beim Herunterladen einer Datei verwendet werden. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
- Die Eigenschaften
downloadURL
undfileName
werden mit dem Speicherort und dem Namen der Download-Datei erstellt. - Im Konstruktor
ProgressEventExample
wird ein neues FileReference-Objekt mit dem Namenfile
erstellt, das dann an dieconfigureListeners()
-Methode übergeben wird. - Die Eigenschaften
downloadURL
undfileName
werden anfile.download()
übergeben. Diese Methode ermittelt dann den Speicherort für den Download der Datei. - Die
configureListeners()
-Methode fügt sieben Ereignis-Listener und die verknüpften Abonnentenmethoden hinzu:cancel
/cancelHandler()
wird ausgelöst, wenn das Herunterladen der Datei abgebrochen wird.complete
/complereHandler()
wird ausgelöst, wenn das Herunterladen der Dateien abgeschlossen ist.ioError
/ioErrorHandler()
wird ausgelöst, wenn die Download-Datei nicht verfügbar oder unzugänglich ist.open
/openHandler()
wird nach Beginn des Download-Vorgangs ausgelöst.progress
/progressHandler()
wird beim Beginn und beim Ende des Download-Vorgangs ausgelöst.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.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); } } }
Tue Jun 12 2018, 10:04 AM Z