LoaderInfo  - AS3

Die ActionScript-Version der geladenen SWF-Datei. Die Sprachversion wird anhand der Zusammenfassung in der ActionScriptVersion-Klasse angegeben, z. B. ActionScriptVersion.ACTIONSCRIPT2 und ActionScriptVersion.ACTIONSCRIPT3.

Hinweis: Diese Eigenschaft besitzt immer entweder den Wert ActionScriptVersion.ACTIONSCRIPT2 oder ActionScriptVersion.ACTIONSCRIPT3. ActionScript 1.0 und 2.0 fallen beide unter den Wert ActionScriptVersion.ACTIONSCRIPT2 (Version 2.0). Diese Eigenschaft unterscheidet nur zwischen ActionScript 1.0/2.0 und ActionScript 3.0.

Verwandte API-Elemente

Wenn eine externe SWF-Datei geladen wird, werden alle in der geladenen Klasse gespeicherten ActionScript 3.0-Definitionen in der Eigenschaft applicationDomain gespeichert.

Der gesamte Code in einer SWF-Datei ist so definiert, dass er sich in einer Anwendungsdomäne befindet. Die aktuelle Anwendungsdomäne ist die Domäne, in der die Hauptanwendung ausgeführt wird. Die Systemdomäne enthält alle Anwendungsdomänen, einschließlich der aktuellen Domäne, und alle Klassen, die von Flash Player oder Adobe AIR verwendet werden.

Mit Ausnahme der Systemdomäne sind alle Anwendungsdomänen mit einer übergeordneten Domäne verknüpft. Die Systemdomäne ist die übergeordnete Domäne der applicationDomain-Eigenschaft der Hauptanwendung. Geladene Klassen werden nur definiert, wenn sie in der jeweiligen Superklasse nicht bereits definiert sind. Die Definition einer geladenen Klasse kann nicht mit einer neueren Definition überschrieben werden.

Beispiele für die Verwendung von Anwendungsdomänen finden Sie im ActionScript 3.0 Entwicklerhandbuch im Kapitel „Clientsystem-Umgebung“.

Verwandte API-Elemente

Die einem LoaderInfo-Objekt zugeordneten Bytes.

Die Anzahl der für das Medium geladenen Bytes. Wenn diese Zahl mit dem Wert von bytesTotal identisch ist, ist das Medium vollständig geladen.

Die Anzahl der komprimierten Bytes in der gesamten Mediendatei.

Bevor das erste progress-Ereignis von dem entsprechenden Loader-Objekt dieses LoaderInfo-Objekts ausgelöst wird, hat bytesTotal den Wert 0. Nach dem ersten progress-Ereignis des Loader-Objekts entspricht bytesTotal der tatsächlich herunterzuladenden Anzahl von Bytes.

Hinweis (nur iOS): Wenn eine Anwendung unter iOS ausgeführt wird, ist der zurückgegebene Wert nicht derselbe wie bei anderen Plattformen.

Verwandte API-Elemente

Drückt die Vertrauensbeziehung von Inhalt (untergeordnetes Objekt) zu Loader (übergeordnetes Objekt) aus. Hat das untergeordnete Objekt den Zugriff durch das übergeordnete Objekt erlaubt, gilt true, sonst gilt false. Diese Eigenschaft wird auf true gesetzt, wenn das untergeordnete Objekt die allowDomain()-Methode aufgerufen hat, um der übergeordneten Domäne die Berechtigung zu erteilen, oder wenn von der untergeordneten Domäne eine URL-Richtlinie geladen wird, die der übergeordneten Domäne die Berechtigung erteilt. Befinden sich das untergeordnete und das übergeordnete Objekt in derselben Domäne, wird diese Eigenschaft auf true gesetzt.

Weitere Informationen zum Thema Sicherheit finden Sie im Flash Player Developer Center im Abschnitt Sicherheit.

Ein Objekt, das über Code des geladenen Inhalts festgelegt werden kann, um Eigenschaften und Methoden bereitzustellen, auf die der Code in der Sandbox des Loader-Objekts zugreifen kann. Diese Sandbox-Brücke ermöglicht Inhalt aus einer nicht zu einer Anwendung gehörigen Domäne den gesteuerten Zugriff auf Skripten in der Sandbox der Anwendung und umgekehrt. Die Sandbox-Brücke dient als Schnittstelle zwischen den Sandboxes und ermöglicht eine explizite Interaktion zwischen Sicherheits-Sandboxes der Anwendung und anderen Sicherheits-Sandboxes.

Verwandte API-Elemente

Das diesem LoaderInfo-Objekt zugeordnete geladene Objekt.

Der MIME-Typ der geladenen Datei. Der Wert ist null, wenn der geladene Anteil der Datei nicht ausreicht, um den Typ zu bestimmen. In der folgenden Liste sind die möglichen Werte enthalten:

• "application/x-shockwave-flash"
• "image/jpeg"
• "image/gif"
• "image/png"

Die nominelle Bildrate der geladenen SWF-Datei, in Bildern pro Sekunde. Diese Zahl ist häufig eine Ganzzahl, was aber nicht zwingend notwendig ist.

Dieser Wert kann von der tatsächlich verwendeten Bildrate abweichen. Flash Player oder Adobe AIR verwendet zu einem bestimmten Zeitpunkt immer nur eine einzige Bildrate für alle geladenen SWF-Dateien. Diese Bildrate wird von der nominellen Bildrate der Haupt-SWF-Datei bestimmt. Die Hauptbildrate kann möglicherweise nicht erreicht werden, je nach Hardware, Tonsynchronisierung und anderen Faktoren.

Die nominelle Höhe der geladenen Datei. Dieser Wert kann von der tatsächlichen Höhe abweichen, in der der Inhalt angezeigt wird, da der geladene Inhalt oder seine übergeordneten Anzeigeobjekte auch skaliert sein können.

Gibt an, ob die LoaderInfo.url-Eigenschaft gekürzt wurde. Wenn isURLInaccessible den Wert true hat, ist der LoaderInfo.url-Wert nur die Domäne der endgültigen URL, von der der Inhalt geladen wird. Die Eigenschaft wird zum Beispiel gekürzt, wenn der Inhalt aus http://www.adobe.com/assets/hello.swf geladen wird und die LoaderInfo.url-Eigenschaft den Wert http://www.adobe.com hat. Der Wert von isURLInaccessible ist nur dann true, wenn auch Folgendes zutrifft:

• Beim Laden des Inhalts ist eine HTTP-Umleitung aufgetreten.
• Die SWF-Datei, die Loader.load() aufruft, stammt aus einer anderen Domäne als die endgültige URL des Inhalts.
• Die SWF-Datei, die Loader.load() aufruft, hat keine Zugriffsberechtigung für den Inhalt. Zugriffsberechtigungen für den Inhalt werden auf die gleiche Weise gewährt wie für BitmapData.draw(): Rufen Sie Security.allowDomain() auf, um auf eine SWF-Datei zuzugreifen (oder, bei Nicht-SWF-Inhalten, richten Sie eine Richtliniendatei ein und verwenden Sie die LoaderContext.checkPolicyFile-Eigenschaft).

Hinweis: Die isURLInaccessible-Eigenschaft wurde für Flash Player 10.1 und AIR 2.0 hinzugefügt. Diese Eigenschaft steht jedoch SWF-Dateien aller Versionen zur Verfügung, wenn die Flash-Laufzeitumgebung dies unterstützt. Die Verwendung einiger Authoring-Tools im „strikten Modus“ führt also zu einem Kompilierungsfehler. Um diesen Fehler zu umgehen, verwenden Sie die indirekte Syntax myLoaderInfo["isURLInaccessible"] oder deaktivieren Sie den strikten Modus. Wenn Sie Flash Professional CS5 oder Flex SDK 4.1 verwenden, können Sie diese API für Laufzeitumgebungen verwenden und kompilieren, die vor Flash Player 10.1 und AIR 2 veröffentlicht wurden.

Für Anwendungsinhalte in AIR ist der Wert dieser Eigenschaft immer false.

Verwandte API-Elemente

Das diesem LoaderInfo-Objekt zugeordnete Loader-Objekt. Wenn es sich bei diesem LoaderInfo-Objekt um die loaderInfo-Eigenschaft der Instanz der SWF-Datei-Hauptklasse handelt, wird kein Loader-Objekt zugeordnet.

Die URL der SWF-Datei, die das Laden des von diesem LoaderInfo-Objekt beschriebenen Mediums initiiert hat. Für die Instanz der Hauptklasse der SWF-Datei entspricht diese URL der URL der SWF-Datei selbst.

Ein Objekt, das Name/Wert-Paare enthält, die die Parameter der geladenen SWF-Datei repräsentieren.

Sie können eine for-in-Schleife verwenden, um alle Namen und Werte aus dem parameters-Objekt zu extrahieren.

Die beiden Quellen für die Parameter sind: der Abfragestring in der URL der Haupt-SWF-Datei und der Wert des FlashVars-HTML-Parameters (dies betrifft nur die Haupt-SWF-Datei).

Die parameters-Eigenschaft ersetzt das in ActionScript 1.0 und 2.0 verwendete Verfahren, bei dem SWF-Dateiparameter als Eigenschaften der Hauptzeitleiste bereitgestellt wurden.

Der Wert der Eigenschaft parameters ist null für Loader-Objekte, die SWF-Dateien enthalten, die ActionScript 1.0 oder 2.0 verwenden. Der Wert ist nur für solche Loader-Objekte ungleich null, die SWF-Dateien enthalten, die ActionScript 3.0 verwenden.

Drückt die Vertrauensbeziehung von Loader (übergeordnetes Objekt) zu Inhalt (untergeordnetes Objekt) aus. Hat das übergeordnete Objekt den Zugriff durch das untergeordnete Objekt erlaubt, gilt true, sonst gilt false. Diese Eigenschaft wird auf true gesetzt, wenn das übergeordnete Objekt die allowDomain()-Methode aufgerufen hat, um der untergeordneten Domäne die Berechtigung zu erteilen, oder wenn von der übergeordneten Domäne eine URL-Richtliniendatei geladen wird, die der untergeordneten Domäne die Berechtigung erteilt. Befinden sich das untergeordnete und das übergeordnete Objekt in derselben Domäne, wird diese Eigenschaft auf true gesetzt.

Weitere Informationen zum Thema Sicherheit finden Sie im Flash Player Developer Center im Abschnitt Sicherheit.

Ein Objekt, das in der Sandbox des Loader-Objekts über Code festgelegt werden kann, um Eigenschaften und Methoden bereitzustellen, auf die der Code des geladenen Inhalts zugreifen kann. Diese Sandbox-Brücke ermöglicht Inhalt aus einer nicht zu einer Anwendung gehörigen Domäne den gesteuerten Zugriff auf Skripten in der Sandbox der Anwendung und umgekehrt. Die Sandbox-Brücke dient als Schnittstelle zwischen den Sandboxes und ermöglicht eine explizite Interaktion zwischen Sicherheits-Sandboxes der Anwendung und anderen Sicherheits-Sandboxes.

Verwandte API-Elemente

Drückt die Domänenbeziehung zwischen dem Loader und dem Inhalt aus: true, wenn beide aus derselben Domäne stammen, sonst false.

Eine EventDispatcher-Instanz, die zum Austauschen von Ereignissen über Sicherheitsgrenzen hinweg verwendet werden kann. Auch wenn das Loader-Objekt und der geladene Inhalt aus Sicherheitsdomänen stammen, die sich gegenseitig nicht vertrauen, können beide auf sharedEvents zugreifen und Ereignisse über dieses Objekt senden und empfangen.

Die Dateiformatversion der geladenen SWF-Datei. Das Dateiformat wird anhand der Zusammenfassung in der SWFVersion-Klasse angegeben, z. B. SWFVersion.FLASH7 und SWFVersion.FLASH9.

Verwandte API-Elemente

Ein Objekt, das ein uncaughtError-Ereignis absetzt, wenn ein nicht verarbeiteter Fehler im Code der SWF-Datei dieses LoaderInfo-Objekts auftritt. Fehler werden nicht erfasst, wenn sie außerhalb von try..catch-Blöcken ausgegeben werden, oder wenn ein ErrorEvent-Objekt ausgelöst wird, aber keine registrierten Listener vorhanden sind.

Wenn Sie in einem Versuchsblock sind, gibt es beispielsweise einen Ereignisverteiler, der seinen Ereignishandler aufruft. Der Erfassungsblock erfasst den Fehler nicht, wenn er in einem Ereignishandler auftritt. Jeder Fehler, der anschließend ausgegeben wird, kann von LoaderInfo.uncaughtErrorEvents erfasst werden

Diese Eigenschaft wird erstellt, wenn die mit diesem LoaderInfo-Objekt verknüpfte SWF-Datei vollständig geladen wurde. Bis dahin hat die uncaughtErrorEvents-Eigenschaft den Wert null. In einem reinen ActionScript-Projekt können Sie während oder nach der Ausführung der Konstruktorfunktion der Hauptklasse der SWF-Datei auf diese Eigenschaft zugreifen. In einem Flex-Projekt ist die uncaughtErrorEvents-Eigenschaft verfügbar, nachdem das applicationComplete-Ereignis abgesetzt wurde.

Verwandte API-Elemente

package
{
    import flash.display.Sprite;
    import flash.events.ErrorEvent;
    import flash.events.MouseEvent;
    import flash.events.UncaughtErrorEvent;

    public class UncaughtErrorEventExample extends Sprite
    {
        public function UncaughtErrorEventExample()
        {
            loaderInfo.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler);
            
            drawUI();
        }
        
        private function uncaughtErrorHandler(event:UncaughtErrorEvent):void
        {
            if (event.error is Error)
            {
                var error:Error = event.error as Error;
                // do something with the error
            }
            else if (event.error is ErrorEvent)
            {
                var errorEvent:ErrorEvent = event.error as ErrorEvent;
                // do something with the error
            }
            else
            {
                // a non-Error, non-ErrorEvent type was thrown and uncaught
            }
        }
        
        private function drawUI():void
        {
            var btn:Sprite = new Sprite();
            btn.graphics.clear();
            btn.graphics.beginFill(0xFFCC00);
            btn.graphics.drawRect(0, 0, 100, 50);
            btn.graphics.endFill();
            addChild(btn);
            btn.addEventListener(MouseEvent.CLICK, clickHandler);
        }
        
        private function clickHandler(event:MouseEvent):void
        {
            throw new Error("Gak!");
        }
    }
}

<?xml version="1.0" encoding="utf-8"?>
<s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" 
                       xmlns:s="library://ns.adobe.com/flex/spark" 
                       xmlns:mx="library://ns.adobe.com/flex/halo"
                       applicationComplete="applicationCompleteHandler();">
    
    <fx:Script>
        <![CDATA[
            import flash.events.ErrorEvent;
            import flash.events.MouseEvent;
            import flash.events.UncaughtErrorEvent;
            
            private function applicationCompleteHandler():void
            {
                loaderInfo.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler);
            }
    
            private function uncaughtErrorHandler(event:UncaughtErrorEvent):void
            {
                if (event.error is Error)
                {
                    var error:Error = event.error as Error;
                    // do something with the error
                }
                else if (event.error is ErrorEvent)
                {
                    var errorEvent:ErrorEvent = event.error as ErrorEvent;
                    // do something with the error
                }
                else
                {
                    // a non-Error, non-ErrorEvent type was thrown and uncaught
                }
            }
            
            private function clickHandler(event:MouseEvent):void
            {
                throw new Error("Gak!");
            }
        ]]>
    </fx:Script>
      
    <s:Button label="Cause Error" click="clickHandler(event);"/>
</s:WindowedApplication>

Die URL des Mediums, das gerade geladen wird.

Bevor das erste progress-Ereignis von dem entsprechenden Loader-Objekt des LoaderInfo-Objekts ausgelöst wird, kann es sein, dass der Wert der url-Eigenschaft nur die ursprünglich in der load()-Methode des Loader-Objekts angegebene URL widerspiegelt. Nach dem ersten progress-Ereignis spiegelt die url-Eigenschaft die endgültige URL des Mediums wider, nachdem etwaige Weiterleitungen und relative URLs aufgelöst wurden.

In einigen Fällen ist der Wert der url-Eigenschaft gekürzt; weitere Informationen finden Sie im Eintrag zur isURLInaccessible-Eigenschaft.

Verwandte API-Elemente

Die nominelle Breite des geladenen Inhalts. Dieser Wert kann von der tatsächlichen Breite abweichen, in der der Inhalt angezeigt wird, da der geladene Inhalt oder seine übergeordneten Anzeigeobjekte auch skaliert sein können.

Gibt das LoaderInfo-Objekt zurück, das mit einer als Objekt definierten SWF-Datei verknüpft ist.

Parameter

Wird nach dem erfolgreichen Laden von Daten ausgelöst. Anders ausgedrückt wird es ausgelöst, wenn alle Inhalte heruntergeladen wurden und das Laden beendet ist. Das Ereignis complete wird immer nach dem Ereignis init ausgelöst. Das init-Ereignis wird ausgelöst, wenn auf das Objekt zugegriffen werden kann, selbst, wenn noch Inhalte heruntergeladen werden.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn eine Netzwerkanforderung über HTTP erfolgt und der HTTP-Statuscode erkannt werden kann.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn die Eigenschaften und Methoden einer geladenen SWF-Datei zugänglich sind und verwendet werden können. Es kann jedoch sein, dass der Inhalt noch immer heruntergeladen wird. Ein LoaderInfo-Objekt löst das init-Ereignis aus, wenn die folgenden Bedingungen erfüllt sind:

• Alle dem geladenen Objekt und dem LoaderInfo-Objekt zugeordneten Eigenschaften und Methoden sind zugänglich.
• Die Konstruktoren für alle untergeordneten Objekte sind abgeschlossen.
• Der gesamte ActionScript-Code im ersten Bild der Hauptzeitleiste der geladenen SWF-Datei wurde ausgeführt.

Zum Beispiel wird ein Event.INIT-Ereignis ausgelöst, wenn das erste Bild eines Films oder einer Animation geladen wird. Der Film ist dann zugänglich und kann der Anzeigeliste hinzugefügt werden. Es kann jedoch länger dauern, bis der gesamte Film heruntergeladen wurde. Event.COMPLETE wird erst ausgelöst, wenn der gesamte Film geladen wurde.

Das Ereignis init wird immer vor dem Ereignis complete ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird beim Auftreten eines Eingabe- oder Ausgabefehlers ausgelöst, durch den der Ladevorgang fehlschlägt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird beim Start eines Ladevorgangs ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn während des Download-Vorgangs Daten empfangen werden.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird von einem LoaderInfo-Objekt ausgelöst, wenn ein geladenes Objekt mit der unload()-Methode des Loader-Objekts entfernt wird oder wenn von demselben Loader-Objekt ein zweiter Ladevorgang durchgeführt und der ursprüngliche Inhalt vor dem Ladebeginn entfernt wird.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

1. Es wird eine url-Eigenschaft erstellt, die den Speicherort und Namen der Bilddatei angibt.
2. Der Klassenkonstruktor erstellt ein Loader-Objekt mit der Bezeichnung loader.
3. Das loader-Objekt instanziiert einen Ereignis-Listener, um sicherzustellen, dass das Bild richtig geladen wird.
4. Der Konstruktor erstellt eine neue Instanz eines URLRequest-Objekts, request, mit Übergabe von url, damit der Dateiname und -speicherort bekannt sind.
5. Das request-Objekt wird an die load()-Methode des loader-Objekts übergeben, die das Bild in die Anzeigeliste lädt.

Wichtig: Zur Ausführung dieses Beispiels müssen Sie eine Datei mit dem Namen „Image.gif“ in dem Ordner ablegen, in dem sich auch die kompilierte SWF-Datei befindet. Verwenden Sie ein Bild mit einem Bereich, der in die Abmessungen der SWF-Hauptdatei passt.

package {
    import flash.display.Loader;
    import flash.display.LoaderInfo;
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.URLRequest;

    public class LoaderInfoExample extends Sprite {
        private var url:String = "Image.gif";

        public function LoaderInfoExample() {
            var loader:Loader = new Loader();
            loader.contentLoaderInfo.addEventListener(Event.INIT, initHandler);
            loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            var request:URLRequest = new URLRequest(url);
            loader.load(request);
            addChild(loader);
        }

        private function initHandler(event:Event):void {
            var loader:Loader = Loader(event.target.loader);
            var info:LoaderInfo = LoaderInfo(loader.contentLoaderInfo);
            trace("initHandler: loaderURL=" + info.loaderURL + " url=" + info.url);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}