LoaderInfo  - AS3

La versione ActionScript del file SWF caricato. La versione del linguaggio viene specificata utilizzando le enumerazioni della classe ActionScriptVersion, come ActionScriptVersion.ACTIONSCRIPT2 e ActionScriptVersion.ACTIONSCRIPT3.

Nota: questa proprietà ha sempre il valore ActionScriptVersion.ACTIONSCRIPT2 o ActionScriptVersion.ACTIONSCRIPT3. ActionScript 1.0 e 2.0 vengono entrambi segnalati come ActionScriptVersion.ACTIONSCRIPT2 (versione 2.0). La proprietà distingue solo ActionScript 1.0 e 2.0 da ActionScript 3.0.

Elementi API correlati

Quando viene caricato un file SWF esterno, tutte le definizioni ActionScript 3.0 contenute nella classe caricata vengono memorizzate nella proprietà applicationDomain.

Tutto il codice presente in un file SWF viene definito come esistente all'interno di un dominio dell'applicazione. Il dominio applicazione corrente è quello in cui viene eseguita l'applicazione principale. Il dominio di sistema contiene tutti i domini delle applicazioni, compreso il dominio corrente e tutte le classi utilizzate da Flash Player o Adobe AIR.

Tutti i domini dell'applicazione, eccetto il dominio di sistema, sono associati a un dominio principale. Il dominio principale del dominio dell'applicazione principale (applicationDomain) è il dominio di sistema. Le classi caricate vengono definite soltanto se non sono già definite dal rispettivo elemento principale. Non è possibile sostituire la definizione di una classe caricata.

Per esempi di utilizzo dei domini dell'applicazione, consultate il capitolo "Ambiente del sistema client" nella Guida per gli sviluppatori di ActionScript 3.0.

Altri esempi

Altre informazioni

Elementi API correlati

I byte associati con un oggetto LoaderInfo.

Il numero di byte caricati per il contenuto multimediale. Quando questo numero è uguale al valore di bytesTotal, tutti i byte sono stati caricati.

Il numero di byte compressi contenuti nell'intero file multimediale.

Prima che il primo evento progress venga inviato dall'oggetto Loader corrispondente a questo oggetto LoaderInfo, bytesTotal è 0. Successivamente al primo evento progress inviato dall'oggetto Loader, bytesTotal riflette il numero effettivo di byte da caricare.

Nota (solo per iOS): quando si esegue un’applicazione in iOS, il valore restituito non è lo stesso delle altre piattaforme.

Elementi API correlati

Esprime la relazione di fiducia dal contenuto (elemento secondario) al Loader (elemento principale). true se l'elemento secondario ha consentito l'accesso all'elemento principale, oppure false in caso contrario. Questa proprietà è impostata su true se l'oggetto secondario ha chiamato il metodo allowDomain() per autorizzare il dominio principale oppure se nel dominio secondario è caricato un file di criteri degli URL che autorizza il dominio principale. Se l'elemento secondario e quello principale sono nello stesso dominio, questa proprietà viene impostata su true.

Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player .

Un oggetto che può essere impostato dal codice del contenuto caricato per presentare le proprietà e i metodi a cui il codice può accedere nella funzione di sicurezza sandbox dell'oggetto Loader. Questo bridge sandbox consente al contenuto proveniente da un dominio diverso da quello dell’applicazione di avere un accesso controllato agli script nella funzione di sicurezza sandbox dell’applicazione, e viceversa. Il bridge sandbox funge da gateway tra le sandbox, fornendo un'interazione esplicita tra le funzioni di sicurezza sandbox dell'applicazione e non dell'applicazione.

Elementi API correlati

L'oggetto caricato associato a questo oggetto LoaderInfo.

Il tipo MIME del file caricato. Questo valore è null se il file non è stato caricato a sufficienza per consentire di determinarne il tipo. Di seguito sono elencati i valori possibili:

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

La frequenza di fotogrammi nominale, in fotogrammi al secondo, del file SWF caricato. Spesso questo numero è intero, ma non deve esserlo necessariamente.

Questo valore può differire dall'effettiva frequenza di fotogrammi utilizzata. Flash Player o Adobe AIR utilizza un'unica frequenza di fotogrammi per tutti i file SWF caricati contemporaneamente, e tale frequenza è determinata dalla frequenza di fotogrammi nominale del file SWF principale. Inoltre, potrebbe non essere possibile raggiungere la frequenza fotogrammi principale, a causa dell'hardware, della sincronizzazione audio e di altri fattori.

L'altezza nominale del file caricato. Questo valore può differire dall'altezza effettiva con la quale il contenuto viene visualizzato, poiché il contenuto caricato dei relativi oggetti di visualizzazione principali potrebbe essere modificato in scala.

Indica se la proprietà LoaderInfo.url è stata troncata. Quando il valore isURLInaccessible è true, il valore LoaderInfo.url corrisponde solo al dominio dell'URL finale dal quale il contenuto è stato caricato. Ad esempio, la proprietà viene troncata se il contenuto viene caricato da http://www.adobe.com/assets/hello.swf e la proprietà LoaderInfo.url ha il valore http://www.adobe.com. Il valore isURLInaccessible è true solo quando tutte le seguenti condizioni sono presenti:

• Si è verificato un reindirizzamento HTTP durante il caricamento del contenuto.
• Il file SWF che chiama Loader.load() proviene da un dominio diverso dall'URL finale del contenuto.
• Il file SWF che chiama Loader.load() non è autorizzato ad accedere al contenuto. L'autorizzazione ad accedere al contenuto viene concessa nello stesso modo dell'autorizzazione per BitmapData.draw(): chiamate Security.allowDomain() per accedere a un file SWF (oppure, per un file diverso da SWF, definite un file di criteri e utilizzate la proprietà LoaderContext.checkPolicyFile).

Nota: la proprietà isURLInaccessible è stata aggiunta per Flash Player 10.1 e AIR 2.0. Tuttavia, questa proprietà viene resa disponibile ai file SWF di tutte le versioni quando è supportata dal runtime di Flash. Di conseguenza, l'uso di alcuni tool di authoring in "modalità rigorosa" causa un errore di compilazione. Per ovviare all'errore, usate la sintassi indiretta myLoaderInfo["isURLInaccessible"] o disattivate la modalità rigorosa. Se usate Flash Professional CS5 o Flex SDK 4.1, potete utilizzare e compilare questa API per i runtime rilasciati prima di Flash Player 10.1 e AIR 2.

Per il contenuto dell'applicazione AIR, il valore di questa proprietà è sempre false.

Elementi API correlati

L'oggetto Loader associato a questo oggetto LoaderInfo. Se questo oggetto LoaderInfo è la proprietà loaderInfo dell'istanza della classe principale del file SWF, non è associato alcun oggetto Loader.

L'URL del file SWF che ha avviato il caricamento del contenuto multimediale descritto da questo oggetto LoaderInfo. Per l'istanza della classe principale del file SWF, questo URL corrisponde a quello dello stesso file SWF.

Un oggetto che contiene coppie nome-valore che rappresentano i parametri passati al file SWF caricato.

È possibile utilizzare un ciclo for-in per estrarre tutti i nomi e i valori dall'oggetto parameters.

Le due origini dei parametri sono la stringa di query nell'URL del file SWF principale e il valore del parametro HTML FlashVars (vale solo per il file SWF principale).

La proprietà parameters sostituisce la tecnica utilizzata in ActionScript 1.0 e 2.0, in base alla quale i parametri del file SWF vengono forniti come proprietà della linea temporale principale.

Il valore della proprietà parameters è null per gli oggetti Loader contenenti file SWF che utilizzano ActionScript 1.0 o 2.0, mentre è diverso da null solo per gli oggetti Loader contenenti file SWF che utilizzano ActionScript 3.0.

Esprime la relazione di fiducia dal Loader (elemento principale) al contenuto (elemento secondario). true se l'elemento principale ha consentito l'accesso all'elemento secondario, oppure false in caso contrario. Questa proprietà è impostata su true se l'oggetto principale ha chiamato il metodo allowDomain() per autorizzare il dominio secondario oppure se nel dominio principale è caricato un file di criteri degli URL che autorizza il dominio secondario. Se l'elemento secondario e quello principale sono nello stesso dominio, questa proprietà viene impostata su true.

Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player .

Un oggetto che può essere impostato dal codice nella funzione sandbox dell'oggetto Loader per presentare le proprietà e i metodi a cui può accedere il codice del contenuto caricato. Questo bridge sandbox consente al contenuto proveniente da un dominio diverso da quello dell’applicazione di avere un accesso controllato agli script nella funzione di sicurezza sandbox dell’applicazione, e viceversa. Il bridge sandbox funge da gateway tra le sandbox, fornendo un'interazione esplicita tra le funzioni di sicurezza sandbox dell'applicazione e non dell'applicazione.

Elementi API correlati

Esprime la relazione di dominio tra il loader e il contenuto: true se hanno lo stesso dominio di origine; false in caso contrario.

Un'istanza EventDispatcher che può essere utilizzata per scambiare eventi tra i limiti di sicurezza. Anche quando l'oggetto Loader e il contenuto caricato provengono da domini di sicurezza che non si accreditano a vicenda, entrambi possono accedere a sharedEvents e inviare e ricevere gli eventi attraverso questo oggetto.

La versione del formato di file del file SWF caricato. Il formato di file viene specificato utilizzando le enumerazioni della classe SWFVersion, come SWFVersion.FLASH7 e SWFVersion.FLASH9.

Elementi API correlati

Un oggetto che invia un evento uncaughtError quando si verifica un errore non gestito nel codice incluso nel file SWF di questo oggetto LoaderInfo. Un errore non rilevato si verifica quando un errore viene generato esternamente a qualsiasi blocco try..catch o quando un oggetto ErrorEvent viene inviato senza listener registrati.

Ad esempio, se in un blocco try c’è un dispatcher di eventi che chiama il gestore di eventi, il blocco catch non rileva l'errore se generato nel gestore di eventi. Ogni errore generato in seguito può quindi essere rilevato intercettando LoaderInfo.uncaughtErrorEvents

Questa proprietà viene creata quando viene completato il caricamento del file SWF associato a questo oggetto LoaderInfo. Fino a quel momento, la proprietà uncaughtErrorEvents è null. In un progetto realizzato completamente in ActionScript, potete accedere a questa proprietà durante o dopo l'esecuzione della funzione di costruzione della classe principale del file SWF. Per un progetto Flex, la proprietà uncaughtErrorEvents è disponibile dopo l'invio dell'evento applicationComplete.

Elementi API correlati

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>

L'URL del contenuto multimediale che viene caricato.

Prima che il primo evento progress venga inviato dall'oggetto Loader corrispondente a questo oggetto LoaderInfo, il valore della proprietà url potrebbe riflettere solo l'URL iniziale specificato nella chiamata al metodo load() dell'oggetto Loader. Successivamente al primo evento progress, la proprietà url riflette l'URL finale del contenuto multimediale, dopo la risoluzione degli eventuali reindirizzamenti e URL relativi.

In alcuni casi, il valore della proprietà url viene troncato; per informazioni dettagliate, vedete la proprietà isURLInaccessible.

Elementi API correlati

La larghezza nominale del contenuto caricato. Questo valore può differire dalla larghezza effettiva con la quale il contenuto viene visualizzato, poiché il contenuto caricato dei relativi oggetti di visualizzazione principali potrebbe essere modificato in scala.

Restituisce l'oggetto LoaderInfo associato con un file SWF definito come oggetto.

Parametri

Inviato quando i dati sono stati caricati correttamente. In altre parole, viene inviato quando tutto il contenuto è stato scaricato e il caricamento è terminato. L'evento complete viene sempre inviato dopo l'evento init. L'evento init viene inviato quando l'oggetto è pronto per l'accesso, anche se il contenuto può essere ancora in fase di scaricamento.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato quando viene effettuata una richiesta di rete su HTTP ed è possibile rilevare il codice di stato HTTP.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato quando le proprietà e i metodi di un file SWF caricato sono accessibili e pronti all'uso. Il contenuto può tuttavia essere ancora in fase di scaricamento. Un oggetto LoaderInfo invia l'evento init in presenza delle condizioni seguenti:

• Tutte le proprietà e i metodi associati con l'oggetto caricato e con l'oggetto LoaderInfo sono accessibili.
• Le funzioni di costruzione di tutti gli oggetti secondari sono state completate.
• Tutto il codice ActionScript nel primo fotogramma della linea temporale principale del file SWF caricato è stato eseguito.

Viene inviato, ad esempio, un evento Event.INIT quando viene caricato il primo fotogramma di un filmato o un'animazione. Il filmato è quindi accessibile e può essere aggiunto all'elenco di visualizzazione. È tuttavia possibile che lo scaricamento del filmato completo richieda più tempo. Event.COMPLETE viene inviato solo dopo che è stato caricato l'intero filmato.

L'evento init viene sempre inviato prima dell'evento complete.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato quando si verifica un errore di input o di output che determina l'esito negativo dell'operazione di caricamento.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato quando inizia un'operazione di caricamento.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato quando vengono ricevuti i dati mentre è in corso l'operazione di scaricamento.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato da un oggetto LoaderInfo ogni volta che un oggetto caricato viene rimosso utilizzando il metodo unload() dell'oggetto Loader, oppure quando viene eseguito un secondo caricamento dallo stesso oggetto Loader e il contenuto originale viene rimosso prima dell'inizio del caricamento.

Questo evento ha le seguenti proprietà:

Elementi API correlati

1. Viene creata una proprietà url, che corrisponde alla posizione e al nome del file di immagine.
2. La funzione di costruzione della classe crea un oggetto Loader di nome loader.
3. L'oggetto loader crea un'istanza di un listener di eventi per garantire che l'immagine venga caricata correttamente.
4. La funzione di costruzione crea una nuova istanza di un oggetto URLRequest, request, passando url in modo che il nome e la posizione del file siano noti.
5. L'oggetto URLRequest request viene quindi passato al metodo load() dell'oggetto loader, che carica l'immagine nell'elenco di visualizzazione.

Importante: questo esempio richiede che un file di nome Image.gif venga aggiunto alla stessa directory del file SWF compilato. Utilizzate un'immagine con un'area che non ecceda le dimensioni del file SWF principale.

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