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.

Vedere anche

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 dell'applicazione, compreso quello corrente; in altri termini, contiene tutte le classi di Flash Player.

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, consultare il capitolo "Ambiente del sistema client" nel manuale Programmazione in ActionScript 3.0.

Vedere anche

I byte associati a 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.

Vedere anche

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 dei domini 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, consultare il capitolo "Sicurezza di Flash Player" nel volume Programmazione in ActionScript 3.0.

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 a Flash Player 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 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, Flash Player potrebbe non essere in grado di raggiungere la frequenza di fotogrammi principale, a seconda del tipo di 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.

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 dei domini 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, consultare il capitolo "Sicurezza di Flash Player" nel volume Programmazione in ActionScript 3.0.

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 se l'oggetto che carica e quello che viene caricato non sono affidabili l'uno rispetto all'altro, entrambi possono accedere a sharedEvents.

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.

Vedere anche

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.

Vedere anche

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.

Versione di Player: Flash Player 9 Aggiornamento 3.

Parametri

Inviato quando i dati sono stati caricati correttamente. L'evento complete viene sempre inviato dopo l'evento init.

Questo evento ha le seguenti proprietà:

Vedere anche

Inviato quando viene eseguita una richiesta di rete via HTTP e Flash Player è in grado di rilevare il codice di stato HTTP.

Questo evento ha le seguenti proprietà:

Vedere anche

Inviato quando le proprietà e i metodi di un file SWF caricato sono accessibili. Un oggetto LoaderInfo invia l'evento init in presenza delle due 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.

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

Questo evento ha le seguenti proprietà:

Vedere anche

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à:

Vedere anche

Inviato quando inizia un'operazione di caricamento.

Questo evento ha le seguenti proprietà:

Vedere anche

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

Questo evento ha le seguenti proprietà:

Vedere anche

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à:

Vedere anche

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