ProLoader  - AS3 Flash

Contiene l'oggetto di visualizzazione principale del file SWF o del file di immagine (JPG, PNG o GIF) caricato mediante il metodo load() o loadBytes().

Restituisce un oggetto ProLoaderInfo corrispondente all'oggetto che viene caricato. Gli oggetti ProLoaderInfo sono condivisi dall'oggetto ProLoader e dall'oggetto del contenuto caricato. L'oggetto ProLoaderInfo fornisce informazioni sullo stato del caricamento e statistiche sul file caricato.

Gli eventi correlati con il caricamento vengono inviati dall'oggetto ProLoaderInfo a cui fa riferimento la proprietà contentLoaderInfo dell'oggetto ProLoader. La proprietà contentLoaderInfo viene impostata su un oggetto ProLoaderInfo valido, anche prima che il contenuto venga caricato, per consentire di aggiungere dei listener di eventi all'oggetto prima del caricamento.

Per rilevare gli errori non rilevati che si verificano in un file SWF caricato, utilizzate la proprietà ProLoader.uncaughtErrorEvents, non la proprietà ProLoader.contentLoaderInfo.uncaughtErrorEvents.

Nota La proprietà contentLoaderInfo restituisce un oggetto ProLoaderInfo. ProLoaderInfo non è una sottoclasse di LoaderInfo e quindi non offre il vantaggio di un inserimento di tipo (cast) implicito nella superclasse. Pertanto, assicuratevi di cambiare le dichiarazioni di tipo da LoaderInfo a ProLoaderInfo.

Un oggetto che invia un evento uncaughtError quando si verifica un errore non gestito nel codice incluso nel file SWF di questo oggetto ProLoader. 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.

Questa proprietà viene creata quando il file SWF associato a questo oggetto ha completato il caricamento. 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.

L'accesso a questa proprietà ProLoader in un lettore che non la supporta genera un errore. Restituisce un oggetto EventDispatcher anziché un oggetto UncaughtErrorEvents per evitare di generare errori nei lettori privi di supporto.

Elementi API correlati

Crea un oggetto ProLoader che può essere utilizzato per caricare file, ad esempio SWF, JPEG, GIF o PNG. Chiamate il metodo load() per caricare la risorsa come elemento secondario dell'istanza ProLoader. Quindi potete aggiungere l'oggetto ProLoader all'elenco di visualizzazione (ad esempio utilizzando il metodo addChild() di un'istanza DisplayObjectContainer). La risorsa appare sullo stage mentre viene caricata.

È anche possibile utilizzare un'istanza ProLoader "fuori elenco", ovvero senza aggiungerla a un contenitore di oggetto di visualizzazione incluso nell'elenco di visualizzazione. In questa modalità, l'istanza Loader potrebbe essere utilizzata per caricare un file SWF che contiene moduli aggiuntivi di un'applicazione.

Per rilevare la fine del caricamento del file SWF, potete utilizzare gli eventi dell'oggetto ProLoaderInfo associato alla proprietà contentLoaderInfo dell'oggetto ProLoader. A quel punto potete eseguire il codice del file SWF del modulo per inizializzare e avviare il modulo. Nella modalità "fuori elenco", un'istanza ProLoader potrebbe essere utilizzata anche per caricare un file SWF che contiene componenti o risorse multimediali. Anche in questo caso potete utilizzare le notifiche di evento dell'oggetto ProLoaderInfo per rilevare la fine del caricamento dei componenti. A quel punto l'applicazione può iniziare a utilizzare i componenti e le risorse multimediali della libreria del file SWF creando istanze delle classi ActionScript 3.0 che rappresentano tali componenti e risorse.

Per determinare lo stato di un oggetto ProLoader, monitorate gli eventi seguenti che l'oggetto ProLoaderInfo ha associato alla proprietà contentLoaderInfo dell'oggetto ProLoader:

• L'evento open viene inviato quando inizia il caricamento.
• L'evento ioError o securityError viene inviato se il file non può essere caricato o se si verifica un errore durante il caricamento.
• L'evento progress viene inviato continuamente durante il caricamento del file.
• L'evento complete viene inviato al termine dello scaricamento di un file, ma prima che siano disponibili i metodi e le proprietà del clip filmato caricato. Se il file SWF caricato usa il precaricamento RSL, questo evento viene inviato al termine del precaricamento RSL. A questo punto, il contenuto reale è disponibile nella proprietà content.
• L'evento init viene inviato dopo che le proprietà e i metodi del file SWF caricato diventano accessibili, in modo da consentire la modifica del file SWF caricato. Questo evento viene inviato prima del gestore complete. Nei file SWF di streaming, l'evento init può essere inviato con largo anticipo rispetto all'evento complete. Nella maggior parte delle situazioni, utilizzate il gestore init. Se il file SWF caricato usa il precaricamento RSL, questo evento viene inviato al termine del precaricamento RSL. A questo punto, il contenuto reale è disponibile nella proprietà content.

Elementi API correlati

Annulla un'operazione del metodo load() attualmente in corso per l'istanza ProLoader.

Carica un file SWF, JPEG, JPEG progressivo, GIF non animato o PNG in un oggetto che è un elemento secondario dell'oggetto ProLoader. Se caricate un file GIF animato, viene visualizzato solo il primo fotogramma. Poiché l'oggetto ProLoader può contenere un unico elemento secondario, una successiva richiesta load() interrompe la richiesta precedente, se è ancora in corso, e avvia un nuovo caricamento.

Nota: in AIR 1.5 e Flash Player 10, la dimensione massima di un'immagine caricata è di 8.191 pixel in larghezza o altezza, mentre il numero totale di pixel non può essere superiore a 16.777.215. (Quindi, se un'immagine caricata ha una larghezza di 8.191 pixel, può avere solo una lunghezza di 2.048 pixel.) In Flash Player 9 e versioni precedenti e in AIR 1.1 e versioni precedenti, la limitazione è di 2.880 pixel in altezza e 2.880 pixel in larghezza.

Un file SWF o un'immagine caricata in un oggetto ProLoader filmato eredita le proprietà di posizione, rotazione e scala degli oggetti di visualizzazione principali dell'oggetto ProLoader.

Utilizzate il metodo unload() per rimuovere i filmati o le immagini caricate con questo metodo o per annullare un'operazione di caricamento in corso.

Potete impedire che un file SWF utilizzi questo metodo impostando il parametro allowNetworking dei tag object ed embed nella pagina HTML che include il contenuto SWF.

Quando utilizzate questo metodo, considerate il modello di sicurezza di Flash Player illustrato nella descrizione della classe ProLoader.

In Flash Player 10 e versioni successive, se utilizzate un Content-Type multipart (ad esempio "multipart/form-data") che contiene un caricamento (indicato da un parametro "filename" in un'intestazione "content-disposition" nel corpo POST), l'operazione POST è soggetta alle regole di sicurezza applicate ai caricamenti:

• L'operazione POST deve essere eseguita come risposta a un'azione compiuta dall'utente, come un clic del mouse o la pressione di un tasto.
• Se l'operazione POST è tra più domini (il target POST non si trova sullo stesso server del file SWF che invia la richiesta POST), il server di destinazione deve fornire un file di criteri URL che consenta l'accesso tra più domini.

Inoltre, per qualsiasi Content-Type in più parti, la sintassi deve essere valida (in conformità allo standard RFC2046). Se la sintassi non è valida, l'operazione POST è soggetta alle regole di sicurezza applicate ai caricamenti.

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

Parametri

Elementi API correlati

Carica dai dati binari memorizzati nell'oggetto ByteArray.

Il metodo loadBytes() è asincrono. Dovete attendere l'evento "init" prima di accedere alle proprietà dell'oggetto caricato.

Quando utilizzate questo metodo, considerate il modello di sicurezza di Flash Player illustrato nella descrizione della classe ProLoader.

Parametri

Elementi API correlati

Carica un'istanza IFilePromise mediante il parametro promise. Il tipo di parametro promise utilizza la superclasse Object invece di IFilePromise per evitare errori in altri lettori.

Il metodo loadFilePromise accetta un oggetto IFilePromise e carica i dati binari. Se i dati sono in un flusso progressivo, ad esempio un video, attendete gli eventi "init" o progress prima di accedere alle proprietà dell'oggetto caricato. Altrimenti, attendete l'evento complete per essere sicuri che i dati siano stati interamente caricati.

Quando utilizzate questo metodo, considerate il modello di sicurezza di Flash Player illustrato nella descrizione della classe ProLoader.

Parametri

Elementi API correlati

Rimuove un elemento secondario di questo oggetto ProLoader caricato mediante il metodo load(). La proprietà dell'oggetto ProLoaderInfo associato viene reimpostata su null. L'elemento secondario non viene necessariamente eliminato perché altri oggetti potrebbero farvi riferimento, tuttavia cessa di essere un elemento secondario dell'oggetto ProLoader.

È buona norma, prima di scaricare un file SWF secondario, chiudere esplicitamente i flussi degli oggetti del file, ad esempio gli oggetti LocalConnection, NetConnection, NetStream e Sound. In caso contrario, la riproduzione dell'audio del file SWF secondario potrebbe continuare anche se il file è stato scaricato. Per chiudere i flussi del file, aggiungete un listener di eventi all'elemento secondario che rileva l'evento unload. Quando l'oggetto principale chiama ProLoader.unload(), l'evento unload viene inviato all'elemento secondario. Il codice di esempio seguente produce il risultato descritto:

function closeAllStreams(evt:Event) { 
    myNetStream.close();
    mySound.close();
    myNetConnection.close();
    myLocalConnection.close();
}

myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

Elementi API correlati