| Pacchetto | fl.display |
| Classe | public class ProLoader |
| Ereditarietà | ProLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS5.5 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Nota ProLoader non è una sottoclasse di flash.display.Loader. Per utilizzare ProLoader, dovete sostituire tutti i riferimenti di tipo Loader con ProLoader.
ProLoader assicura un'esperienza di caricamento uniforme. È specialmente utile con i file SWF che usano il precaricamento RSL. Ad esempio, i file SWF che contengono testo TLF utilizzano il precaricamento RSL per impostazione predefinita. In questi casi, ProLoaderInfo ritarda l'invio degli eventi INIT o COMPLETE fino al momento in cui il precaricamento RSL è completo e il contenuto reale è effettivamente disponibile. Di conseguenza, la proprietà content può quindi accedere al contenuto reale. ProLoader permette anche di evitare altri problemi, quali:
- Eventi
addedToStageeremovedFromStagesupplementari - Contenuto caricato nell'elemento superiore errato nel fotogramma uno (nel caso di contenuto pubblicato per Flash Player 10.2 o successivo con Flash Professional CS5.5 o successivo).
Avvertenza Alcuni membri ProLoader non supportano tutte le versioni del runtime. Accedete a questi membri solo se sono supportati dalla versione di pubblicazione di AIR o Flash Player. In caso contrario, queste API generano errori runtime. I membri con supporto runtime limitato includono i metodi e le proprietà seguenti:
-
unloadAndStop() -
loadFilePromise() -
uncaughtErrorEvents
Consultate l'argomento di riferimento per ciascuna API per verificarne il supporto in runtime.
Altre informazioni
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
L'implementazione di accessibilità corrente (AccessibilityImplementation) di questa istanza InteractiveObject. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
Le opzioni di accessibilità correnti di questo oggetto di visualizzazione. | DisplayObject | |
| alpha : Number
Indica il valore della trasparenza alfa dell'oggetto specificato. | DisplayObject | |
| blendMode : String
Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare. | DisplayObject | |
| blendShader : Shader [sola scrittura]
Imposta uno shader utilizzato per la fusione dei colori di primo piano e sfondo. | DisplayObject | |
| buttonMode : Boolean
Specifica la modalità pulsante di questo sprite. | Sprite | |
| cacheAsBitmap : Boolean
Se è impostata su true, nella cache dei runtime Flash viene memorizzata una rappresentazione bitmap interna dell'oggetto di visualizzazione. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Se il valore è diverso da null, questo oggetto Matrix definisce il modo in cui viene eseguito il rendering di un oggetto di visualizzazione quando cacheAsBitmap è impostato su true. | DisplayObject | |
| constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| content : DisplayObject [sola lettura]
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(). | ProLoader | ||
| contentLoaderInfo : ProLoaderInfo [sola lettura]
Restituisce un oggetto ProLoaderInfo corrispondente all'oggetto che viene caricato. | ProLoader | ||
| contextMenu : NativeMenu
Specifica il menu di scelta rapida associato all'oggetto. | InteractiveObject | |
| doubleClickEnabled : Boolean
Specifica se l'oggetto riceve gli eventi doubleClick. | InteractiveObject | |
| dropTarget : DisplayObject [sola lettura]
Specifica l'oggetto di visualizzazione sopra il quale viene trascinato lo sprite o sul quale viene rilasciato. | Sprite | |
| filters : Array
Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione. | DisplayObject | |
| focusRect : Object
Specifica se l'oggetto visualizza un rettangolo di attivazione. | InteractiveObject | |
| graphics : Graphics [sola lettura]
Specifica l'oggetto Graphics che appartiene a questo oggetto Sprite, in cui possono essere eseguiti i comandi di disegno vettoriale. | Sprite | |
| height : Number
Indica l'altezza dell'oggetto di visualizzazione espressa in pixel. | DisplayObject | |
| hitArea : Sprite
Definisce un altro sprite come area attiva di uno sprite. | Sprite | |
| loaderInfo : LoaderInfo [sola lettura]
Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene. | DisplayObject | |
| mask : DisplayObject
L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato. | DisplayObject | |
| metaData : Object
Ottiene l’oggetto di metadati dell’istanza DisplayObject se i metadati sono stati memorizzati insieme all’istanza di questo DisplayObject nel file SWF mediante un tag PlaceObject4. | DisplayObject | |
| mouseChildren : Boolean
Determina se gli elementi secondari dell'oggetto sono abilitati o meno per il mouse o per il dispositivo di input dell'utente. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Specifica se questo oggetto riceve messaggi del mouse o di altri dispositivi di input dell'utente. | InteractiveObject | |
| mouseX : Number [sola lettura]
Indica la coordinata x del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | DisplayObject | |
| mouseY : Number [sola lettura]
Indica la coordinata y del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | DisplayObject | |
| name : String
Indica il nome dell'istanza dell'oggetto DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Specifica se deve essere visualizzata una tastiera virtuale (una tastiera software a video) quando questa istanza InteractiveObject riceve lo stato di attivazione. | InteractiveObject | |
| numChildren : int [sola lettura]
Restituisce il numero di elementi secondari di questo oggetto. | DisplayObjectContainer | |
| opaqueBackground : Object
Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo. | DisplayObject | |
| parent : DisplayObjectContainer [sola lettura]
Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione. | DisplayObject | |
| root : DisplayObject [sola lettura]
Nel caso di un oggetto di visualizzazione all'interno di un file SWF caricato, la proprietà principale è l'oggetto di visualizzazione più in alto nella porzione della struttura dell'elenco di visualizzazione rappresentata da quel file SWF. | DisplayObject | |
| rotation : Number
Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale. | DisplayObject | |
| rotationX : Number
Indica la rotazione dell'asse x dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | |
| rotationY : Number
Indica la rotazione dell'asse y dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | |
| rotationZ : Number
Indica la rotazione dell'asse z dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | |
| scale9Grid : Rectangle
La griglia di modifica in scala attualmente attiva. | DisplayObject | |
| scaleX : Number
Indica la scala orizzontale (percentuale) dell'oggetto applicata dal punto di registrazione. | DisplayObject | |
| scaleY : Number
Indica la scala verticale (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | DisplayObject | |
| scaleZ : Number
Indica la scala di profondità (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | DisplayObject | |
| scrollRect : Rectangle
I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione. | DisplayObject | |
| softKeyboard : String
Controlla l'aspetto della tastiera software. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Definisce l’area che deve rimanere visibile sullo schermo quando è visualizzata una tastiera virtuale (non disponibile in iOS). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Controlla il suono nello sprite. | Sprite | |
| stage : Stage [sola lettura]
Lo stage dell'oggetto di visualizzazione. | DisplayObject | |
| tabChildren : Boolean
Determina se gli elementi secondari dell'oggetto sono abilitati per la tabulazione. | DisplayObjectContainer | |
| tabEnabled : Boolean
Specifica se questo oggetto è incluso nell'ordine di tabulazione. | InteractiveObject | |
| tabIndex : int
Specifica l'ordine di tabulazione degli oggetti in un file SWF. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [sola lettura]
Restituisce un oggetto TextSnapshot per questa istanza DisplayObjectContainer. | DisplayObjectContainer | |
| transform : flash.geom:Transform
Un oggetto con proprietà relative alla matrice, alla trasformazione del colore e ai limiti di pixel di un oggetto di visualizzazione. | DisplayObject | |
| uncaughtErrorEvents : EventDispatcher [sola lettura]
Un oggetto che invia un evento uncaughtError quando si verifica un errore non gestito nel codice incluso nel file SWF di questo oggetto ProLoader. | ProLoader | ||
| useHandCursor : Boolean
Un valore booleano che indica se viene visualizzato un cursore a forma di mano quando il puntatore passa sopra uno sprite in cui la proprietà buttonMode è impostata su true. | Sprite | |
| visible : Boolean
Determina se l'oggetto di visualizzazione è visibile o meno. | DisplayObject | |
| width : Number
Indica la larghezza dell'oggetto di visualizzazione espressa in pixel. | DisplayObject | |
| x : Number
Indica la coordinata x dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | DisplayObject | |
| y : Number
Indica la coordinata y dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | DisplayObject | |
| z : Number
Indica la posizione della coordinata z lungo l'asse z dell'istanza DisplayObject relativa al contenitore principale 3D. | DisplayObject | |
| Metodo | Definito da | ||
|---|---|---|---|
Crea un oggetto ProLoader che può essere utilizzato per caricare file, ad esempio SWF, JPEG, GIF o PNG. | ProLoader | ||
|
Aggiunge un'istanza secondaria DisplayObject a questa istanza DisplayObjectContainer. | DisplayObjectContainer | |
|
Aggiunge un'istanza secondaria DisplayObject a questa istanza DisplayObjectContainer. | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
|
Indica se le restrizioni di sicurezza possono determinare l'omissione di eventuali oggetti di visualizzazione dall'elenco restituito dalla chiamata al metodo DisplayObjectContainer.getObjectsUnderPoint() con il punto specificato. | DisplayObjectContainer | |
Annulla un'operazione del metodo load() attualmente in corso per l'istanza ProLoader. | ProLoader | ||
|
Determina se l'oggetto di visualizzazione specificato è un elemento secondario dell'istanza DisplayObjectContainer oppure è l'istanza stessa. | DisplayObjectContainer | |
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace. | DisplayObject | |
|
Restituisce l'istanza dell'oggetto di visualizzazione secondario che si trova in corrispondenza della posizione di indice specificata. | DisplayObjectContainer | |
|
Restituisce l'oggetto di visualizzazione secondario al quale corrisponde il nome specificato. | DisplayObjectContainer | |
|
Restituisce la posizione di indice di un'istanza DisplayObject secondaria. | DisplayObjectContainer | |
|
Restituisce un array di oggetti che si trovano sotto il punto specificato e sono elementi secondari (di uno o più livelli inferiori) di questa istanza DisplayObjectContainer. | DisplayObjectContainer | |
|
Restituisce un rettangolo che definisce i bordi dell'oggetto di visualizzazione in base al sistema di coordinate definito dal parametro targetCoordinateSpace, esclusi gli eventuali tratti presenti sulle forme. | DisplayObject | |
|
Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point. | DisplayObject | |
|
Converte un punto bidimensionale dalle coordinate dello stage (globali) in quelle (locali) di un oggetto di visualizzazione tridimensionale. | DisplayObject | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Valuta il riquadro di delimitazione dell'oggetto di visualizzazione per verificare se si sovrappone o si interseca con il riquadro di delimitazione dell'oggetto di visualizzazione obj. | DisplayObject | |
|
Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y. | DisplayObject | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
Carica un file SWF, JPEG, JPEG progressivo, GIF non animato o PNG in un oggetto che è un elemento secondario dell'oggetto ProLoader. | ProLoader | ||
Carica dai dati binari memorizzati nell'oggetto ByteArray. | ProLoader | ||
Carica un'istanza IFilePromise mediante il parametro promise. | ProLoader | ||
|
Converte un punto tridimensionale delle coordinate (locali) dell'oggetto di visualizzazione tridimensionale in un punto bidimensionale nelle coordinate dello stage (globali). | DisplayObject | |
|
Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point. | DisplayObject | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove l'istanza DisplayObject secondaria specificata dall'elenco degli elementi secondari dell'istanza DisplayObjectContainer. | DisplayObjectContainer | |
|
Rimuove un'istanza DisplayObject secondaria dalla posizione di indice specificata nell'elenco degli elementi secondari di DisplayObjectContainer. | DisplayObjectContainer | |
|
Rimuove tutte le istanze DisplayObject secondarie dall'elenco degli elementi secondari dell'istanza DisplayObjectContainer. | DisplayObjectContainer | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
|
Alza una tastiera virtuale. | InteractiveObject | |
|
Cambia la posizione di un elemento secondario nel contenitore di oggetto di visualizzazione. | DisplayObjectContainer | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Consente all'utente di trascinare lo sprite specificato. | Sprite | |
|
Consente all'utente di trascinare lo sprite specificato su un dispositivo abilitato per il tocco. | Sprite | |
|
Interrompe in modo ricorsivo l’esecuzione della linea temporale di qualsiasi MovieClips che ha origine in questo oggetto. | DisplayObjectContainer | |
|
Termina il metodo startDrag(). | Sprite | |
|
Termina il metodo startTouchDrag(), utilizzato con i dispositivi abilitati per il tocco. | Sprite | |
|
Scambia lo z-order (ordine di profondità) degli oggetti secondari specificati. | DisplayObjectContainer | |
|
Scambia lo z-order (ordine di profondità) degli oggetti secondari nelle due posizioni di indice specificate nell'elenco degli elementi secondari. | DisplayObjectContainer | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
Rimuove un elemento secondario di questo oggetto ProLoader caricato mediante il metodo load(). | ProLoader | ||
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
content | proprietà |
content:DisplayObject [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS5.5 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
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().
Implementazione
public function get content():DisplayObjectGenera
SecurityError — Il file SWF o i file di immagine caricato appartiene a una sicurezza sandbox alla quale non si ha accesso. Per un file SWF caricato, potete evitare questa situazione chiamando nel file il metodo Security.allowDomain() o specificando nel file un parametro loaderContext con la proprietà securityDomain impostata su SecurityDomain.currentDomain quando chiamate il metodo load() o loadBytes().
|
contentLoaderInfo | proprietà |
contentLoaderInfo:ProLoaderInfo [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS5.5 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
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.
Implementazione
public function get contentLoaderInfo():ProLoaderInfouncaughtErrorEvents | proprietà |
uncaughtErrorEvents:EventDispatcher [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS5.5 |
| Versioni runtime: | Flash Player 10.1, AIR 2.0 |
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.
Implementazione
public function get uncaughtErrorEvents():EventDispatcherElementi API correlati
ProLoader | () | Funzione di costruzione |
public function ProLoader()| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS5.5 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
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
openviene inviato quando inizia il caricamento. - L'evento
ioErrorosecurityErrorviene inviato se il file non può essere caricato o se si verifica un errore durante il caricamento. - L'evento
progressviene inviato continuamente durante il caricamento del file. - L'evento
completeviene 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
initviene 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 gestorecomplete. Nei file SWF di streaming, l'eventoinitpuò essere inviato con largo anticipo rispetto all'eventocomplete. Nella maggior parte delle situazioni, utilizzate il gestoreinit. 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
close | () | metodo |
public function close():void| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS5.5 |
| Versioni runtime: | AIR 1.0, Flash Player Player - 9 |
Annulla un'operazione del metodo load() attualmente in corso per l'istanza ProLoader.
load | () | metodo |
public function load(request:URLRequest, context:LoaderContext = null):void| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS5.5 |
| Versioni runtime: | Flash Player 9, AIR 1.0, Flash Player Player - 9 |
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
request:URLRequest — L'URL assoluto o relativo del file SWF, JPEG, GIF o PNG da caricare. Un percorso relativo deve essere relativo al file SWF principale. Gli URL assoluti devono includere il riferimento al protocollo, ad esempio http:// o file://. I nomi file non devono contenere specifiche relative all'unità disco.
| |
context:LoaderContext (default = null)
Se il parametro Per informazioni dettagliate, vedete la descrizione delle proprietà del metodo LoaderContext. |
Eventi
asyncError: — Inviato dall'oggetto contentLoaderInfo se è stata specificata la proprietà LoaderContext.requestedContentParent e non è possibile aggiungere il contenuto caricato come elemento secondario del DisplayObjectContainer specificato. Questa condizione può verificarsi se il contenuto caricato è un flash.display.AVM1Movie o se la chiamata addChild() a requestedContentParent genera un errore.
| |
complete: — Inviato dall'oggetto contentLoaderInfo al termine del caricamento del file. L'evento complete viene sempre inviato dopo l'evento init.
| |
httpStatus: — Inviato dall'oggetto contentLoaderInfo quando viene eseguita una richiesta di rete via HTTP e Flash Player è in grado di rilevare il codice di stato HTTP.
| |
init: — Inviato dall'oggetto contentLoaderInfo quando le proprietà e i metodi del file SWF caricato sono accessibili. L'evento init viene sempre inviato prima dell'evento complete.
| |
ioError: — Inviato dall'oggetto contentLoaderInfo quando si verifica un errore di input o di output che determina l'esito negativo dell'operazione di caricamento.
| |
open: — Inviato dall'oggetto contentLoaderInfo all'inizio del caricamento.
| |
progress: — Inviato dall'oggetto contentLoaderInfo mentre vengono ricevuti i dati durante l'operazione di caricamento.
| |
securityError: — Inviato dall'oggetto contentLoaderInfo se un file SWF nella sandbox locale con file system tenta di caricare contenuto nella sandbox locale con rete, o viceversa.
| |
securityError: — Inviato dall'oggetto contentLoaderInfo se è stata specificata la proprietà LoaderContext.requestedContentParent e la sandbox di sicurezza di LoaderContext.requestedContentParent non ha accesso al file SWF caricato.
| |
unload: — Inviato dall'oggetto contentLoaderInfo quando un oggetto caricato viene rimosso.
|
Genera
IOError — La proprietà digest dell'oggetto request non è null. È necessario impostare solo la proprietà digest quando si chiama il metodo URLLoader.load() durante il caricamento di un file SWZ (un componente della piattaforma Adobe).
| |
SecurityError — Il valore di LoaderContext.securityDomain deve essere null o SecurityDomain.currentDomain. Ciò dipende dal fatto che è possibile collocare il contenuto multimediale caricato solo nella sua sandbox di sicurezza naturale o nella propria sandbox di sicurezza personalizzata (in questo caso è necessario un file di criteri).
| |
SecurityError — I file SWF locali non possono impostare LoaderContext.securityDomain su un valore diverso da null. Non è consentito importare contenuti multimediali non locali in una sandbox locale o collocare altri contenuti multimediali locali in una sandbox diversa da quella naturale.
| |
SecurityError — Non potete collegarvi alle porte comunemente riservate. Per un elenco completo di porte bloccate, vedete "Limitazioni delle API di connettività di rete" nella Guida per gli sviluppatori di ActionScript 3.0.
| |
SecurityError — Se la proprietà applicationDomain o securityDomain del parametro context proviene da un dominio non consentito.
| |
SecurityError — Se un file SWF locale sta tentando di utilizzare la proprietà securityDomain del parametro context.
| |
IllegalOperationError — Se la proprietà requestedContentParent del parametro context è un ProLoader.
| |
IllegalOperationError — Se il parametro LoaderContext.parameters è impostato su un valore non null e include valori diversi da Strings.
|
Elementi API correlati
loadBytes | () | metodo |
public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS5.5 |
| Versioni runtime: | Flash Player 9, AIR 1.0, Flash Player 9 |
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
bytes:ByteArray — Un oggetto ByteArray. Il contenuto dell'oggetto ByteArray può essere in uno qualunque dei formati di file supportati dalla classe ProLoader: SWF, GIF, JPEG o PNG.
| |
context:LoaderContext (default = null)applicationDomain dell'oggetto LoaderContext è applicabile, mentre le proprietà checkPolicyFile e securityDomain non lo sono.
Se il parametro Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player . |
Eventi
asyncError: — Inviato dall'oggetto contentLoaderInfo se è stata specificata la proprietà LoaderContext.requestedContentParent e non è possibile aggiungere il contenuto caricato come elemento secondario del DisplayObjectContainer specificato. Questa condizione può verificarsi se il contenuto caricato è un flash.display.AVM1Movie o se la chiamata addChild() a requestedContentParent genera un errore.
| |
complete: — Inviato dall'oggetto contentLoaderInfo quando l'operazione è completa. L'evento complete viene sempre inviato dopo l'evento init.
| |
init: — Inviato dall'oggetto contentLoaderInfo quando le proprietà e i metodi dei dati caricati sono accessibili. L'evento init viene sempre inviato prima dell'evento complete.
| |
ioError: — Inviato dall'oggetto contentLoaderInfo quando il runtime non è in grado di analizzare i dati nell'array di byte.
| |
open: — Inviato dall'oggetto contentLoaderInfo all'inizio dell'operazione.
| |
progress: — Inviato dall'oggetto contentLoaderInfo mentre i dati vengono trasferiti in memoria.
| |
securityError: — Inviato dall'oggetto contentLoaderInfo se è stata specificata la proprietà LoaderContext.requestedContentParent e la sandbox di sicurezza di LoaderContext.requestedContentParent non ha accesso al file SWF caricato.
| |
unload: — Inviato dall'oggetto contentLoaderInfo quando un oggetto caricato viene rimosso.
|
Genera
ArgumentError — Se la proprietà length dell'oggetto ByteArray non è maggiore di 0.
| |
IllegalOperationError — Se la proprietà checkPolicyFile o securityDomain del parametro context è diversa da null.
| |
IllegalOperationError — Se la proprietà requestedContentParent del parametro context è un ProLoader.
| |
IllegalOperationError — Se il parametro LoaderContext.parameters è impostato su un valore non null e include valori diversi da Strings.
| |
SecurityError — Se la proprietà applicationDomain del parametro context proviene da un dominio non consentito.
| |
SecurityError — Non potete collegarvi alle porte comunemente riservate. Per un elenco completo di porte bloccate, vedete "Limitazioni delle API di connettività di rete" nella Guida per gli sviluppatori di ActionScript 3.0.
|
Elementi API correlati
loadFilePromise | () | metodo |
public function loadFilePromise(promise:Object, context:LoaderContext = null):void| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS5.5 |
| Versioni runtime: | AIR 2.5, AIR 2.0, Flash Player 9 |
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
promise:Object — Un oggetto IFilePromise. L'origine dati dell'oggetto può essere in uno qualunque dei formati di file supportati dalla classe ProLoader: SWF, GIF, JPEG o PNG.
| |
context:LoaderContext (default = null)applicationDomain dell'oggetto LoaderContext è applicabile, mentre le proprietà checkPolicyFile e securityDomain non lo sono.
Se il parametro Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player . |
Eventi
asyncError: — Inviato dall'oggetto contentLoaderInfo se è stata specificata la proprietà LoaderContext.requestedContentParent e non è possibile aggiungere il contenuto caricato come elemento secondario del DisplayObjectContainer specificato. Questa condizione può verificarsi se il contenuto caricato è un flash.display.AVM1Movie o se la chiamata addChild() a requestedContentParent genera un errore.
| |
complete: — Inviato dall'oggetto contentLoaderInfo quando l'operazione è completa. L'evento complete viene sempre inviato dopo l'evento init.
| |
init: — Inviato dall'oggetto contentLoaderInfo quando le proprietà e i metodi dei dati caricati sono accessibili. L'evento init viene sempre inviato prima dell'evento complete.
| |
ioError: — Inviato dall'oggetto contentLoaderInfo quando il runtime non è in grado di analizzare i dati nell'origine dati oppure se il flusso dell'origine dati non è leggibile.
| |
open: — Inviato dall'oggetto contentLoaderInfo all'inizio dell'operazione.
| |
progress: — Inviato dall'oggetto contentLoaderInfo mentre i dati vengono trasferiti in memoria.
| |
securityError: — Inviato dall'oggetto contentLoaderInfo se è stata specificata la proprietà LoaderContext.requestedContentParent e la sandbox di sicurezza di LoaderContext.requestedContentParent non ha accesso al file SWF caricato.
| |
unload: — Inviato dall'oggetto contentLoaderInfo quando un oggetto caricato viene rimosso.
Avvertenza L'accesso a questa API non eseguito da un'applicazione AIR genera un errore. |
Genera
IllegalOperationError — Se la proprietà requestedContentParent del parametro context è un oggetto ProLoader.
| |
IllegalOperationError — Se il parametro LoaderContext.parameters è impostato su un valore non null e include valori diversi da Strings.
| |
ArgumentError — Se l'oggetto IFilePromise passato come parametro è null.
|
Elementi API correlati
unload | () | metodo |
public function unload():void| Versione linguaggio: | ActionScript 3.0 |
| Versione prodotto: | Flash CS5.5 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
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
Tue Jun 12 2018, 02:44 PM Z