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...
fl.rsl 

RSLInfo  - AS3 Flash

Paketfl.rsl
Klassepublic class RSLInfo
VererbungRSLInfo Inheritance EventDispatcher Inheritance Object
Unterklassen SWZInfo

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Die RSLInfo-Klasse ermöglicht Ihnen, die Verwendung von RSLs (Runtime Shared Library-Dateien, gemeinsam genutzte Bibliotheken) zu spezifizieren. Eine Reihe von URLs kann mit addEntry() hinzufügt werden (sowohl für die SWF-Datei als auch für eine erforderliche Richtliniendatei). Die RSLInfo-Klasse kann die folgenden Ereignisse absetzen: Event.COMPLETE, IOErrorEvent.IO_ERROR, SecurityErrorEvent.SECURITY_ERROR und ProgressEvent.PROGRESS. Wegen der Verwendung von Failovers ist der RSL-Download selbst beim Absetzen von SecurityErrorEvents oder IOErrorEvents nicht fehlgeschlagen, bis die failed-Eigenschaft den Wert true zurückgibt.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  bytesLoaded : int
[schreibgeschützt] Gibt für alle Dateien, die geladen werden, an, wie viele Bytes bis jetzt geladen wurden.
RSLInfo
  bytesTotal : int
[schreibgeschützt] Gibt für alle Dateien, die geladen werden, an, wie viele Bytes insgesamt bis jetzt geladen wurden.
RSLInfo
  complete : Boolean
[schreibgeschützt] Gibt den Wert "true" zurück, wenn der Download erfolgreich abgeschlossen wurde, und "false", wenn der Download noch nicht abgeschlossen ist oder fehlgeschlagen ist.
RSLInfo
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  currentAttemptIndex : int
[schreibgeschützt] Gibt den Index der URL zurück, die zurzeit den Download auszuführen versucht.
RSLInfo
  failed : Boolean
[schreibgeschützt] Gibt den Wert „true“ zurück, wenn der Download fehlgeschlagen ist, und „false“, wenn der Download noch nicht abgeschlossen ist oder erfolgreich abgeschlossen wurde.
RSLInfo
  loader : Loader
[schreibgeschützt] Gibt den Loader zurück, der für den RSL-Download verwendet wird.
RSLInfo
  policyFileURLs : Array
[schreibgeschützt] Gibt ein Array von Richtliniendatei-URLs zurück, die über addEntry() hinzugefügt wurden.
RSLInfo
  rslURLs : Array
[schreibgeschützt] Gibt ein Array von RSL-URLs zurück, die über addEntry() hinzugefügt wurden.
RSLInfo
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
RSLInfo
  
addEntry(url:String, policyFileURL:String = null):void
Fügt eine Reihe von URLs (RSL-Dateien und Richtliniendateien) hinzu.
RSLInfo
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
Startet den RSL-Download.
RSLInfo
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
Eigenschaftendetails

bytesLoaded

Eigenschaft
bytesLoaded:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Gibt für alle Dateien, die geladen werden, an, wie viele Bytes bis jetzt geladen wurden. Da einige Ladevorgänge möglicherweise fehlschlagen und über Failover-URLs geleitet werden, kann sich der Wert von bytesLoaded mit der Zeit erhöhen oder verringern. Fortschrittsbalken müssen dies ausgleichen, damit sich der Balken nicht rückwärts bewegt.



Implementierung
    public function get bytesLoaded():int

bytesTotal

Eigenschaft 
bytesTotal:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Gibt für alle Dateien, die geladen werden, an, wie viele Bytes insgesamt bis jetzt geladen wurden. Da einige Ladevorgänge möglicherweise fehlschlagen und über Failover-URLs geleitet werden, kann sich der Wert von bytesTotal mit der Zeit erhöhen oder verringern. Fortschrittsbalken müssen dies ausgleichen, damit sich der Balken nicht rückwärts bewegt.



Implementierung
    public function get bytesTotal():int

complete

Eigenschaft 
complete:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Gibt den Wert true zurück, wenn der Download erfolgreich abgeschlossen wurde, und false, wenn der Download noch nicht abgeschlossen ist oder fehlgeschlagen ist.



Implementierung
    public function get complete():Boolean

currentAttemptIndex

Eigenschaft 
currentAttemptIndex:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Gibt den Index der URL zurück, die zurzeit den Download auszuführen versucht. Wenn Fehlschlagereignisse empfangen werden, zeigt dieser Index auf die fehlgeschlagene URL. Der Index gehört zu den Arrays rslURLSs und policyFileURLs. Vor Beginn des Downloads ist der Indexwert -1; nach Abschluss des Downloads ist er identisch mit der Länge der Arrays. Deshalb wird eine Bereichsüberprüfung empfohlen, bevor dieser Wert für den Zugriff auf ein Mitglied des URL-Arrays verwendet wird.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         info.addEventListener(IOErrorEvent.IO_ERROR, handleErr);
         function handleErr(e:Event) {
         trace('error: ' + e);
         trace('on download of url: ' + info.rslURLs[info.currentAttemptIndex]);
         }
         



Implementierung
    public function get currentAttemptIndex():int

failed

Eigenschaft 
failed:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Gibt den Wert true zurück, wenn der Download fehlgeschlagen ist, und false, wenn der Download noch nicht abgeschlossen ist oder erfolgreich abgeschlossen wurde. Die failed-Eigenschaft wird nicht auf true gesetzt, wenn eine einzelne URL fehlgeschlagen ist und es noch Failover-URLs gibt, die ausprobiert werden können.



Implementierung
    public function get failed():Boolean

loader

Eigenschaft 
loader:Loader  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Gibt den Loader zurück, der für den RSL-Download verwendet wird. Kann NULL sein. Die Loader-Instanz wird erstellt, nachdem load() aufgerufen wurde.



Implementierung
    public function get loader():Loader

policyFileURLs

Eigenschaft 
policyFileURLs:Array  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Gibt ein Array von Richtliniendatei-URLs zurück, die über addEntry() hinzugefügt wurden. Behandeln Sie dieses Array als schreibgeschützt. Fügen Sie Einträge hinzu, indem Sie addEntry() aufrufen. Die direkte Bearbeitung dieses Arrays führt zu unvorhergesehenen Ergebnissen.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         for (var i:int = 0; i < info.policyFileURLs.length; i++) {
            trace('url: ' + info.policyFileURLs[i]);
         }
         



Implementierung
    public function get policyFileURLs():Array

Verwandte API-Elemente

rslURLs

Eigenschaft 
rslURLs:Array  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Gibt ein Array von RSL-URLs zurück, die über addEntry() hinzugefügt wurden. Behandeln Sie dieses Array als schreibgeschützt. Fügen Sie Einträge hinzu, indem Sie addEntry() aufrufen. Die direkte Bearbeitung dieses Arrays führt zu unvorhergesehenen Ergebnissen.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         for (var i:int = 0; i < info.rslURLs.length; i++) {
            trace('url: ' + info.rslURLs[i]);
         }
         



Implementierung
    public function get rslURLs():Array

Verwandte API-Elemente

Konstruktordetails

RSLInfo

()Konstruktor
public function RSLInfo()

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Konstruktor.

Methodendetails

addEntry

()Methode
public function addEntry(url:String, policyFileURL:String = null):void

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Fügt eine Reihe von URLs (RSL-Dateien und Richtliniendateien) hinzu. Die Reihenfolge, in der die URLs hinzugefügt werden, ist von ihrer Downloadpriorität abhängig. Die erste URL wird zuerst ausprobiert, die zweite wird erst ausprobiert, wenn die erste fehlgeschlagen ist usw. Richtliniendateien werden nur hinzufügt, wenn die URL der entsprechenden RSL-Datei heruntergeladen wird.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         info.addEntry('rsl.swf');
         myPreloader.addRSLInfo(info);
         myPreloader.start();
         

Parameter

url:String
 
policyFileURL:String (default = null)

load

()Methode 
public function load():void

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Startet den RSL-Download. Der erste hinzugefügte Eintrag wird zuerst ausprobiert. Nachfolgende Einträge werden als Backup ausprobiert, wenn es zu Fehlschlägen kommt.





[ 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.