UILoader

Pacchetto	fl.containers
Classe	public class UILoader
Ereditarietà	UILoader UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

La classe UILoader consente di impostare il contenuto da caricare e successivamente di monitorare l'operazione di caricamento in fase di runtime. Questa classe gestisce inoltre il ridimensionamento del contenuto caricato. Se caricate il contenuto da un dominio o da una sandbox diversi, le proprietà del contenuto potrebbero risultare inaccessibili per motivi di sicurezza. Per ulteriori informazioni, vedete la classe ProLoader.

L'impostazione di una proprietà della classe UILoader con ActionScript ha la priorità sul parametro con lo stesso nome impostato nella finestra di ispezione Proprietà oppure nella finestra di ispezione dei componenti.

Questo componente racchiude fl.display.ProLoader. La classe ProLoader gestisce tutto l'effettivo caricamento; UILoader fornisce solo una visualizzazione dell'oggetto ProLoader.

Nota: quando il contenuto viene caricato da un dominio diverso o da una sandbox diversa, le proprietà del contenuto potrebbero risultare inaccessibili per motivi di sicurezza. Per ulteriori informazioni su come la sicurezza del dominio influisce sul processo di caricamento, vedere la classe ProLoader.

Vedere gli esempi

Elementi API correlati

ProLoader

Proprietà pubbliche

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
		autoLoad : Boolean Ottiene o imposta un valore che indica se l'istanza UILoader carica automaticamente il contenuto specificato.	UILoader
		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
		bytesLoaded : uint [sola lettura] Ottiene il conteggio dei byte di contenuto che sono stati caricati.	UILoader
		bytesTotal : uint [sola lettura] Ottiene il conteggio dei byte di contenuto da caricare.	UILoader
		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 (JPEG, PNG o GIF) caricato mediante il metodo load() o mediante l'impostazione della proprietà source.	UILoader
		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
		enabled : Boolean Ottiene o imposta un valore che indica se il componente può accettare l'interazione dell'utente.	UIComponent
		filters : Array Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione.	DisplayObject
		focusEnabled : Boolean Ottiene o imposta un valore booleano che indica se il componente può ricevere l'attivazione quando un utente fa clic su di esso.	UIComponent
		focusManager : IFocusManager Ottiene o imposta il FocusManager che controlla l'attivazione di questo componente e dei suoi pari.	UIComponent
		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 [override] Ottiene o imposta l'altezza del componente in pixel.	UIComponent
		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
		maintainAspectRatio : Boolean Ottiene o imposta un valore che indica se mantenere il rapporto proporzionale utilizzato nell'immagine originale o se ridimensionare l'immagine utilizzando la larghezza e l'altezza correnti del componente UILoader.	UILoader
		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
		mouseFocusEnabled : Boolean Ottiene o imposta un valore che indica se il componente può ricevere l'attivazione quando un utente fa clic su di esso.	UIComponent
		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
		percentLoaded : Number [sola lettura] Ottiene un numero compreso tra 0 e 100 che indica la percentuale di contenuto caricato.	UILoader
		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
		scaleContent : Boolean Ottiene o imposta un valore che indica se modificare automaticamente in scala l'immagine fino alla dimensione dell'istanza UILoader.	UILoader
		scaleX : Number [override] Moltiplica la larghezza corrente del componente per un fattore di scala.	UIComponent
		scaleY : Number [override] Moltiplica l'altezza corrente del componente per un fattore di scala.	UIComponent
		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
		source : Object Ottiene o imposta l'URL assoluto o relativo che identifica la posizione del file SWF o del file di immagine da caricare, il nome di classe di un clip filmato della libreria, un riferimento a un oggetto di visualizzazione oppure il nome di istanza di un clip filmato sullo stesso livello del componente.	UILoader
		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
		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 [override] Ottiene o imposta un valore che indica se l'istanza corrente del componente è visibile.	UIComponent
		width : Number [override] Ottiene o imposta la larghezza del componente in pixel.	UIComponent
		x : Number [override] Ottiene o imposta la coordinata x che rappresenta la posizione del componente sull'asse x nel contenitore principale.	UIComponent
		y : Number [override] Ottiene o imposta la coordinata y che rappresenta la posizione del componente sull'asse y nel contenitore principale.	UIComponent
		z : Number Indica la posizione della coordinata z lungo l'asse z dell'istanza DisplayObject relativa al contenitore principale 3D.	DisplayObject

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		UILoader() Crea una nuova istanza del componente UILoader.	UILoader
		addChild(child:DisplayObject):DisplayObject Aggiunge un'istanza secondaria DisplayObject a questa istanza DisplayObjectContainer.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 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
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 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
		clearStyle(style:String):void Elimina una proprietà di stile dall'istanza del componente.	UIComponent
		close():void Annulla un'operazione del metodo load() attualmente in corso per l'istanza ProLoader.	UILoader
		contains(child:DisplayObject):Boolean Determina se l'oggetto di visualizzazione specificato è un elemento secondario dell'istanza DisplayObjectContainer oppure è l'istanza stessa.	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		drawFocus(focused:Boolean):void Mostra o nasconde l'indicatore di attivazione sul componente.	UIComponent
		drawNow():void Avvia un'azione di disegno immediata, senza invalidare tutto come fa invalidateNow.	UIComponent
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace.	DisplayObject
		getChildAt(index:int):DisplayObject Restituisce l'istanza dell'oggetto di visualizzazione secondario che si trova in corrispondenza della posizione di indice specificata.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject Restituisce l'oggetto di visualizzazione secondario al quale corrisponde il nome specificato.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int Restituisce la posizione di indice di un'istanza DisplayObject secondaria.	DisplayObjectContainer
		getFocus():InteractiveObject Recupera l'oggetto che è l'elemento attivo corrente.	UIComponent
		getObjectsUnderPoint(point:Point):Array 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
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 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
		getStyle(style:String):Object Recupera una proprietà style impostata nella catena di ricerca dello stile del componente.	UIComponent
		getStyleDefinition():Object [statico] Recupera la mappa di stile predefinita del componente corrente.	UILoader
		globalToLocal(point:Point):Point Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point.	DisplayObject
		globalToLocal3D(point:Point):Vector3D Converte un punto bidimensionale dalle coordinate dello stage (globali) in quelle (locali) di un oggetto di visualizzazione tridimensionale.	DisplayObject
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		hitTestObject(obj:DisplayObject):Boolean 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
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y.	DisplayObject
		invalidate(property:String, callLater:Boolean = true):void Contrassegna una proprietà come non valida e ridisegna il componente sul fotogramma successivo salvo diversa indicazione.	UIComponent
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		load(request:URLRequest = null, context:LoaderContext = null):void Carica il contenuto specificato oppure, se non è specificato alcun contenuto, carica il contenuto dalla posizione identificata dalla proprietà source.	UILoader
		loadBytes(bytes:ByteArray, context:LoaderContext = null):void Carica dai dati binari memorizzati in un oggetto ByteArray.	UILoader
		local3DToGlobal(point3d:Vector3D):Point Converte un punto tridimensionale delle coordinate (locali) dell'oggetto di visualizzazione tridimensionale in un punto bidimensionale nelle coordinate dello stage (globali).	DisplayObject
		localToGlobal(point:Point):Point Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point.	DisplayObject
		mergeStyles(... list):Object [statico] Unisce gli stili di più classi in un unico oggetto.	UIComponent
		move(x:Number, y:Number):void Sposta il componente in una posizione specificata all'interno del relativo elemento principale.	UIComponent
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeChild(child:DisplayObject):DisplayObject Rimuove l'istanza DisplayObject secondaria specificata dall'elenco degli elementi secondari dell'istanza DisplayObjectContainer.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject Rimuove un'istanza DisplayObject secondaria dalla posizione di indice specificata nell'elenco degli elementi secondari di DisplayObjectContainer.	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void Rimuove tutte le istanze DisplayObject secondarie dall'elenco degli elementi secondari dell'istanza DisplayObjectContainer.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		requestSoftKeyboard():Boolean Alza una tastiera virtuale.	InteractiveObject
		setChildIndex(child:DisplayObject, index:int):void Cambia la posizione di un elemento secondario nel contenitore di oggetto di visualizzazione.	DisplayObjectContainer
		setFocus():void Imposta questo componente come elemento attivo.	UIComponent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		setSize(w:Number, h:Number):void [override] Ridimensiona il componente in base alle dimensioni richieste.	UILoader
		setStyle(style:String, value:Object):void Imposta una proprietà di stile per l'istanza del componente.	UIComponent
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Consente all'utente di trascinare lo sprite specificato.	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void Consente all'utente di trascinare lo sprite specificato su un dispositivo abilitato per il tocco.	Sprite
		stopAllMovieClips():void Interrompe in modo ricorsivo l’esecuzione della linea temporale di qualsiasi MovieClips che ha origine in questo oggetto.	DisplayObjectContainer
		stopDrag():void Termina il metodo startDrag().	Sprite
		stopTouchDrag(touchPointID:int):void Termina il metodo startTouchDrag(), utilizzato con i dispositivi abilitati per il tocco.	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void Scambia lo z-order (ordine di profondità) degli oggetti secondari specificati.	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void Scambia lo z-order (ordine di profondità) degli oggetti secondari nelle due posizioni di indice specificate nell'elenco degli elementi secondari.	DisplayObjectContainer
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		unload():void Rimuove un elemento secondario di questo oggetto UILoader caricato mediante il metodo load() o la proprietà source.	UILoader
		validateNow():void Convalida e aggiorna le proprietà e il layout di questo oggetto e lo ridisegna, se necessario.	UIComponent
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Metodi protetti

Nascondi metodi protetti ereditati

Mostra metodi protetti ereditati

	Metodo		Definito da
		getStyleValue(name:String):Object Restituisce lo stile specificato per un componente, considerando tutti gli stili impostati a livello globale, di componente e di istanza.	UIComponent

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
added	Inviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione.	DisplayObject
addedToStage	Inviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione sullo stage, sia direttamente o mediante l'aggiunta di una sottostruttura ad albero che contiene l'oggetto di visualizzazione.	DisplayObject
clear	Inviato quando l'utente sceglie "Cancella" (o "Elimina") dal menu di scelta rapida per il testo.	InteractiveObject
click	Inviato quando l'utente preme e rilascia il pulsante principale del dispositivo di puntamento sopra lo stesso InteractiveObject.	InteractiveObject
complete	Inviato quando il caricamento del contenuto è completato.	UILoader
contextMenu	Inviato quando un'azione dell'utente causa la visualizzazione del menu di scelta rapida associato a questo oggetto interattivo in un'applicazione AIR.	InteractiveObject
copy	Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di tagliare oppure sceglie "Taglia" dal menu di scelta rapida per il testo.	InteractiveObject
cut	Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di tagliare oppure sceglie "Taglia" dal menu di scelta rapida testuale.	InteractiveObject
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher
doubleClick	Inviato quando l'utente preme e rilascia il pulsante principale di un dispositivo di puntamento due volte in rapida successione sopra la stessa istanza InteractiveObject quando il flag doubleClickEnabled dell'oggetto è impostato su true.	InteractiveObject
enterFrame	[evento di trasmissione] Inviato quando l'indicatore di riproduzione sta entrando in un nuovo fotogramma.	DisplayObject
exitFrame	[evento di trasmissione] Inviato quando l'indicatore di riproduzione sta per uscire dal fotogramma corrente.	DisplayObject
focusIn	Inviato dopo che un oggetto di visualizzazione ha ricevuto lo stato di attivazione.	InteractiveObject
focusOut	Inviato dopo che un oggetto di visualizzazione ha perso lo stato di attivazione.	InteractiveObject
frameConstructed	[evento di trasmissione] Inviato dopo l'esecuzione delle funzioni di costruzione degli oggetti di visualizzazione dei fotogrammi, ma prima dell'esecuzione degli script di fotogramma.	DisplayObject
gestureDirectionalTap	Inviato quanto l’utente crea un punto di contatto lungo il bordo della superficie di contatto con un’istanza di InteractiveObject (ad esempio toccando bordo della superficie di contatto in Siri Remote per Apple TV). Alcuni dispositivi possono inoltre interpretare questo contatto come una combinazione di più eventi touch.	InteractiveObject
gestureLongPress	Inviato quanto l'utente preme due punti di contatto sulla stessa istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, preme e rilascia due dita su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).	InteractiveObject
gesturePan	Inviato quanto l'utente sposta un punto di contatto sull'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, sposta un dito da sinistra a destra su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).	InteractiveObject
gestureRotate	Inviato quanto l'utente esegue un'operazione di rotazione in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con due dita e le ruota su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).	InteractiveObject
gestureSwipe	Inviato quanto l'utente esegue un'operazione di tocco in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con tre dita e quindi le sposta parallelamente su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).	InteractiveObject
gestureTap	Inviato quanto l'utente crea un punto di contatto con un'istanza InteractiveObject, quindi tocca un dispositivo abilitato per il tocco (ad esempio, posiziona più dita su un oggetto di visualizzazione per aprire un menu e quindi tocca con un dito per selezionare una voce di menu su un cellulare o su un Tablet PC con touch screen).	InteractiveObject
gestureZoom	Inviato quanto l'utente esegue un'operazione di zoom in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con due dita e allontana velocemente le dita su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).	InteractiveObject
hide	Inviato dopo che il componente è passato da visibile a invisibile.	UIComponent
imeStartComposition	Questo evento viene inviato a qualsiasi applicazione client che supporti input in linea con un IME.	InteractiveObject
init	Inviato quando le proprietà e i metodi di un file SWF caricato sono accessibili.	UILoader
ioError	Inviato quando si verifica un errore di input o di output.	UILoader
keyDown	Inviato quando l'utente preme un tasto.	InteractiveObject
keyFocusChange	Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando la tastiera.	InteractiveObject
keyUp	Inviato quando l'utente rilascia un tasto.	InteractiveObject
middleClick	Inviato quando l'utente preme e rilascia il pulsante centrale del dispositivo di puntamento sopra lo stesso InteractiveObject.	InteractiveObject
middleMouseDown	Inviato quando un utente preme il pulsante centrale del dispositivo di puntamento su un'istanza InteractiveObject.	InteractiveObject
middleMouseUp	Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.	InteractiveObject
mouseDown	Inviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.	InteractiveObject
mouseFocusChange	Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando un dispositivo di puntamento.	InteractiveObject
mouseMove	Inviato quando l'utente sposta il dispositivo di puntamento mentre si trova sopra un'istanza InteractiveObject.	InteractiveObject
mouseOut	Inviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject.	InteractiveObject
mouseOver	Inviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject.	InteractiveObject
mouseUp	Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.	InteractiveObject
mouseWheel	Inviato quando si fa ruotare la rotella del mouse su un'istanza InteractiveObject.	InteractiveObject
move	Inviato dopo che il componente viene spostato.	UIComponent
nativeDragComplete	Inviato dall'iniziatore del trascinamento InteractiveObject quando l'utente rilascia il trascinamento.	InteractiveObject
nativeDragDrop	Inviato dall'InteractiveObject di destinazione quando un oggetto trascinato viene rilasciato su di esso e il rilascio è stato accettato con una chiamata a DragManager.acceptDragDrop().	InteractiveObject
nativeDragEnter	Inviato da un InteractiveObject quando un trascinamento entra nei suoi limiti.	InteractiveObject
nativeDragExit	Inviato da un InteractiveObject quando un trascinamento esce dai propri limiti.	InteractiveObject
nativeDragOver	Inviato continuamente da un InteractiveObject mentre un'azione di trascinamento rimane all'interno dei suoi limiti.	InteractiveObject
nativeDragStart	Inviato all'inizio di un'operazione di trascinamento dall'InteractiveObject che è specificato come iniziatore del trascinamento nella chiamata a DragManager.doDrag().	InteractiveObject
nativeDragUpdate	Inviato durante un'operazione di trascinamento dall'InteractiveObject che è specificato come iniziatore del trascinamento nella chiamata a DragManager.doDrag().	InteractiveObject
open	Inviato dopo l'inizio di un'operazione di rete.	UILoader
paste	Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di incollare oppure sceglie "Incolla" dal menu di scelta rapida testuale.	InteractiveObject
progress	Inviato quando il contenuto è in fase di caricamento.	UILoader
proximityBegin	Inviato quando l'utente abbassa uno stilo attivo oltre la soglia di rilevamento della prossimità dello schermo.	InteractiveObject
proximityEnd	Inviato quando l'utente solleva uno stilo attivo sopra la soglia di rilevamento della prossimità dello schermo.	InteractiveObject
proximityMove	Inviato quando l'utente sposta uno stilo attivo sullo schermo rimanendo entro la soglia di rilevamento della prossimità.	InteractiveObject
proximityOut	Inviato quando l'utente allontana uno stilo attivo da questo InteractiveObject rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo.	InteractiveObject
proximityOver	Inviato quando l'utente sposta uno stilo attivo direttamente sopra questo InteractiveObject rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo.	InteractiveObject
proximityRollOut	Inviato quando l'utente allontana uno stilo attivo da questo InteractiveObject o da qualsiasi suo elemento secondario rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo.	InteractiveObject
proximityRollOver	Inviato quando l'utente sposta uno stilo attivo sopra questo InteractiveObject dall'esterno della struttura di discendenti dell'oggetto nell'elenco di visualizzazione (rimanendo entro la soglia di rilevamento della prossimità dello schermo).	InteractiveObject
releaseOutside	Inviato quando un utente rilascia il pulsante del dispositivo di puntamento dopo averlo premuto sopra un’istanza InteractiveObject e aver quindi spostato il dispositivo di puntamento fuori dell’istanza stessa.	InteractiveObject
removed	Inviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione.	DisplayObject
removedFromStage	Inviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione sullo stage, sia direttamente o mediante la rimozione di una sottostruttura ad albero che contiene l'oggetto di visualizzazione.	DisplayObject
render	[evento di trasmissione] Inviato quando stanno per essere eseguiti l'aggiornamento e il rendering dell'elenco di visualizzazione.	DisplayObject
resize	Inviato dopo che il componente viene ridimensionato.	UILoader
rightClick	Inviato quando l'utente preme e rilascia il pulsante destro del dispositivo di puntamento sopra lo stesso InteractiveObject.	InteractiveObject
rightMouseDown	Inviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.	InteractiveObject
rightMouseUp	Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.	InteractiveObject
rollOut	Inviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject.	InteractiveObject
rollOver	Inviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject.	InteractiveObject
securityError	Inviato dopo che si è verificato un errore di sicurezza durante il caricamento del contenuto.	UILoader
selectAll	Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di selezionare tutto oppure sceglie "Seleziona tutto" dal menu di scelta rapida testuale.	InteractiveObject
show	Inviato dopo che il componente è passato da invisibile a visibile.	UIComponent
softKeyboardActivate	Inviato immediatamente dopo la visualizzazione della tastiera software.	InteractiveObject
softKeyboardActivating	Inviato immediatamente prima della visualizzazione della tastiera software.	InteractiveObject
softKeyboardDeactivate	Inviato immediatamente dopo la chiusura della tastiera software.	InteractiveObject
tabChildrenChange	Inviato quando cambia il valore del flag tabChildren dell'oggetto.	InteractiveObject
tabEnabledChange	Inviato quando cambia il flag tabEnabled dell'oggetto.	InteractiveObject
tabIndexChange	Inviato quando cambia il valore della proprietà tabIndex dell'oggetto.	InteractiveObject
textInput	Inviato quando un utente immette uno o più caratteri di testo.	InteractiveObject
touchBegin	Inviato quanto l'utente stabilisce per la prima volta un contatto con un dispositivo abilitato per il tocco (ad esempio, tocca con un dito un cellulare o un Tablet PC con touch screen).	InteractiveObject
touchEnd	Inviato quanto l'utente rimuove il contatto con un dispositivo abilitato per il tocco (ad esempio, solleva un dito da un cellulare o un Tablet PC con touch screen).	InteractiveObject
touchMove	Inviato quando l'utente tocca il dispositivo, e viene inviato in modo continuativo finché il punto di contatto non viene rimosso.	InteractiveObject
touchOut	Inviato quanto l'utente sposta il punto di contatto lontano da un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un oggetto di visualizzazione a un altro disponibile su un cellulare o su un Tablet PC con touch screen).	InteractiveObject
touchOver	Inviato quanto l'utente sposta il punto di contatto su un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un punto esterno a un oggetto di visualizzazione a un punto su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).	InteractiveObject
touchRollOut	Inviato quanto l'utente sposta il punto di contatto lontano da un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un oggetto di visualizzazione a un punto esterno a un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).	InteractiveObject
touchRollOver	Inviato quanto l'utente sposta il punto di contatto su un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un punto esterno a un oggetto di visualizzazione a un punto su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).	InteractiveObject
touchTap	Inviato quanto l'utente solleva il punto di contatto sulla stessa istanza InteractiveObject in corrispondenza della quale è stato iniziato il contatto su un dispositivo abilitato per il tocco (ad esempio, preme e rilascia un dito da un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).	InteractiveObject

Stili

Gli stili sono di tipo comune oppure associati a un tema specifico. Se lo stile è comune, può essere utilizzato con qualunque tema. Se è associato a un tema specifico, può essere utilizzato solo se la vostra applicazione ne fa uso.

Stili comuni

Fate clic per visualizzare altre informazioni sugli stili

Nascondi stili ereditati

Mostra stili ereditati

	Descrizione	Definito da
disabledTextFormat	Tipo: flash.text.TextFormat Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 L'oggetto TextFormat da utilizzare per il rendering dell'etichetta del componente quando il pulsante è disattivato.	UIComponent
focusRectPadding	Tipo: Number Formato: Length Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 Il riempimento che separa i margini esterni del componente dai bordi esterni dell'indicatore di attivazione, in pixel.	UIComponent
focusRectSkin	Tipo: Class Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 Lo skin da utilizzare per la visualizzazione degli indicatori di attivazione.	UIComponent
textFormat	Tipo: flash.text.TextFormat Versione linguaggio: ActionScript 3.0 Versione prodotto: Flash CS3 Versioni runtime: Flash9.0.28.0, AIR 1.0 L'oggetto TextFormat da utilizzare per il rendering dell'etichetta del componente.	UIComponent

Costanti pubbliche

Nascondi costanti pubbliche ereditate

Mostra costanti pubbliche ereditate

	Costante		Definito da
		version : String = "3.0.3.1" Numero di versione dei componenti.	UIComponent

Descrizione delle proprietà

autoLoad

proprietà

autoLoad:Boolean

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Ottiene o imposta un valore che indica se l'istanza UILoader carica automaticamente il contenuto specificato. Il valore true indica che UILoader carica automaticamente il contenuto; il valore false indica che il contenuto non viene caricato finché non viene chiamato il metodo load().

Il valore predefinito è true.

Implementazione
public function get autoLoad():Boolean
public function set autoLoad(value:Boolean):void

Elementi API correlati

load()
source

Esempio ( Come utilizzare questo esempio )

L'esempio seguente mostra come l'impostazione della proprietà autoLoad su false impedisce che il contenuto venga caricato finché il metodo load() non viene chiamato:


import fl.containers.UILoader;
import fl.controls.Button;

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 40);
addChild(myUILoader);

var myButton:Button = new Button();
myButton.label = "Load image";
myButton.move(10, 10);
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myButton);

function clickHandler(event:MouseEvent):void {
    myUILoader.load();
}

bytesLoaded

proprietà

bytesLoaded:uint [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Ottiene il conteggio dei byte di contenuto che sono stati caricati. Quando questa proprietà è uguale al valore di bytesTotal, tutti i byte sono stati caricati.

Il valore predefinito è 0.

Implementazione
public function get bytesLoaded():uint

Elementi API correlati

bytesTotal
percentLoaded

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un'istanza del componente UILoader, che visualizza un'immagine caricata, e istanze dei componenti ProgressBar e Label, che mostrano lo stato dello scaricamento dell'immagine:


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

bytesTotal

proprietà

bytesTotal:uint [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Ottiene il conteggio dei byte di contenuto da caricare.

Il valore predefinito è 0.

Implementazione
public function get bytesTotal():uint

Elementi API correlati

bytesLoaded
percentLoaded

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un'istanza del componente UILoader, che visualizza un'immagine caricata, e istanze dei componenti ProgressBar e Label, che mostrano lo stato dello scaricamento dell'immagine:


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

content

proprietà

content:DisplayObject [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Contiene l'oggetto di visualizzazione principale del file SWF o del file di immagine (JPEG, PNG o GIF) caricato mediante il metodo load() o mediante l'impostazione della proprietà source. Il valore è undefined fino all'inizio del caricamento. Impostate le proprietà del contenuto all'interno di una funzione gestore di eventi per l'evento complete.

Il valore predefinito è null.

Implementazione
public function get content():DisplayObject

Elementi API correlati

complete
load()
source

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un componente Slider che modifica la trasparenza del contenuto di un oggetto UILoader:


import fl.controls.Slider;
import fl.containers.UILoader;
import fl.events.SliderEvent;

var s:Slider = new Slider();
s.minimum = 10;
s.maximum = 100;
s.liveDragging = true;
s.value = s.maximum;
s.move(10,10);
s.addEventListener(SliderEvent.THUMB_DRAG, updateUILoaderContentAlpha);
addChild(s);

var loader:UILoader = new UILoader();
loader.move(10,40);
loader.setSize(400, 300);
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

function updateUILoaderContentAlpha(e:SliderEvent):void {
    loader.content.alpha = s.value/100;
}

maintainAspectRatio

proprietà

maintainAspectRatio:Boolean

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Ottiene o imposta un valore che indica se mantenere il rapporto proporzionale utilizzato nell'immagine originale o se ridimensionare l'immagine utilizzando la larghezza e l'altezza correnti del componente UILoader. Il valore true indica che il rapporto proporzionale viene mantenuto; il valore false indica che il contenuto caricato viene ridimensionato in base alle dimensioni correnti di UILoader.

Per utilizzare questa proprietà, dovete impostare la proprietà scaleContent su false, altrimenti la proprietà viene ignorata.

Il valore predefinito è true.

Implementazione
public function get maintainAspectRatio():Boolean
public function set maintainAspectRatio(value:Boolean):void

Elementi API correlati

scaleContent

Esempio ( Come utilizzare questo esempio )

L'esempio seguente utilizza una casella di controllo per attivare il valore della proprietà maintainAspectRatio:


import fl.containers.UILoader;
import fl.controls.CheckBox;

var myUILoader:UILoader = new UILoader();
myUILoader.setSize(200, 200);
myUILoader.scaleContent = true;
myUILoader.maintainAspectRatio = true;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.move(10, 10);
addChild(myUILoader);

var myCheckBox:CheckBox = new CheckBox();
myCheckBox.label = "maintainAspectRatio";
myCheckBox.selected = myUILoader.maintainAspectRatio;
myCheckBox.width = 150;
myCheckBox.move(220, 10);
myCheckBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myCheckBox);

function changeHandler(event:Event):void {
    myUILoader.maintainAspectRatio = event.target.selected;
}

percentLoaded

proprietà

percentLoaded:Number [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Ottiene un numero compreso tra 0 e 100 che indica la percentuale di contenuto caricato. Se caricate risorse dalla libreria e non un contenuto caricato esternamente, la proprietà percentLoaded è impostata su 0.

Il valore predefinito è 0.

Implementazione
public function get percentLoaded():Number

Elementi API correlati

bytesLoaded
bytesTotal

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un'istanza del componente UILoader, che visualizza un'immagine caricata, e istanze dei componenti ProgressBar e Label, che mostrano lo stato dello scaricamento dell'immagine:


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

scaleContent

proprietà

scaleContent:Boolean

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Ottiene o imposta un valore che indica se modificare automaticamente in scala l'immagine fino alla dimensione dell'istanza UILoader. Il valore true indica che l'immagine viene modificata automaticamente in scala fino alla dimensione dell'istanza UILoader; il valore false indica che il contenuto caricato viene automaticamente modificato in scala fino alle sue dimensioni predefinite.

Il valore predefinito è true.

Implementazione
public function get scaleContent():Boolean
public function set scaleContent(value:Boolean):void

Elementi API correlati

maintainAspectRatio

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un oggetto UILoader che carica un'immagine e ha dimensioni corrispondenti a quelle dell'immagine:


import fl.containers.UILoader;

var loader:UILoader = new UILoader();
loader.scaleContent = false;
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

source

proprietà

source:Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Ottiene o imposta l'URL assoluto o relativo che identifica la posizione del file SWF o del file di immagine da caricare, il nome di classe di un clip filmato della libreria, un riferimento a un oggetto di visualizzazione oppure il nome di istanza di un clip filmato sullo stesso livello del componente.

I formati di file di immagine validi includono GIF, PNG e JPEG. Per caricare una risorsa mediante un oggetto URLRequest, utilizzate il metodo load().

Il valore predefinito è null.

Implementazione
public function get source():Object
public function set source(value:Object):void

Elementi API correlati

autoLoad
load()

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un oggetto UILoader che carica un'immagine e ha dimensioni corrispondenti a quelle dell'immagine:

import fl.containers.UILoader;

var loader:UILoader = new UILoader();
loader.scaleContent = false;
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function UILoader()

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Crea una nuova istanza del componente UILoader.

Descrizione dei metodi

close

()

metodo

public function close():void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Annulla un'operazione del metodo load() attualmente in corso per l'istanza ProLoader. Il metodo load() può essere chiamato anche dal parametro source.

Genera

Error — Per l'oggetto URLStream non è aperto alcun flusso.

Elementi API correlati

load()
source

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un'istanza del componente UILoader e un'istanza del componente Button che consente di annullare lo scaricamento dell'immagine dell'istanza UILoader:


import fl.containers.UILoader;
import fl.controls.Button;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 30);
addChild(myUILoader);

var cancelButton:Button = new Button();
cancelButton.label = "Cancel download";
cancelButton.move(10, 10);
cancelButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(cancelButton);

function clickHandler(event:MouseEvent):void {
    var uil:UILoader = myUILoader;
    try {
        uil.close();
        trace("Download cancelled:", uil.source);
    } catch (error:Error) {
        trace("Unable to cancel download.", error.message);
    }
}

getStyleDefinition

()

metodo

public static function getStyleDefinition():Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Recupera la mappa di stile predefinita del componente corrente. La mappa di stile contiene il tipo appropriato per il componente, in base allo stile utilizzato dal componente. Ad esempio, lo stile disabledTextFormat contiene un valore null o un oggetto TextFormat. È possibile utilizzare questi stili e chiamare setStyle() sul componente corrente. Il codice seguente consente di ignorare lo stile disabledTextFormat predefinito sul componente specificato:

componentInstance.setStyle("disabledTextFormat", new TextFormat());

Restituisce

Object — Oggetto stili predefinito.

Elementi API correlati

UIComponent.getStyle()
UIComponent.setStyle()
StyleManager

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un browser di stili per varie classi di componenti:

import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}

load

()

metodo

public function load(request:URLRequest = null, context:LoaderContext = null):void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Carica il contenuto specificato oppure, se non è specificato alcun contenuto, carica il contenuto dalla posizione identificata dalla proprietà source. Per impostazione predefinita, l'oggetto LoaderContext utilizza il dominio corrente come dominio applicazione. Per specificare un dominio applicazione diverso, per verificare un file dei criteri o per modificare il dominio di sicurezza, inizializzate un nuovo oggetto LoaderContext e passarlo a questo metodo.

Per impostazione predefinita, la proprietà context utilizza il dominio corrente. Per specificare un ApplicationDomain diverso, per verificare un file dei criteri o per modificare SecurityDomain, passate un nuovo oggetto LoaderContext.

Parametri

	`request:URLRequest` (default = `null`) — L'oggetto URLRequest che identifica la posizione da cui caricare il contenuto. Se questo valore non è specificato, viene usato il valore corrente della proprietà `contentPath` come posizione del contenuto.

	`context:LoaderContext` (default = `null`) — L'oggetto LoaderContext che imposta il contesto dell'operazione di caricamento.

Elementi API correlati

autoLoad
close()
source
unload()
flash.system.ApplicationDomain
flash.system.LoaderContext

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea una nuova istanza UILoader e carica un'immagine utilizzando il metodo load() con la proprietà source:


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.load();
myUILoader.move(10, 10);
addChild(myUILoader);

L'esempio seguente crea una nuova istanza UILoader e carica un'immagine utilizzando il metodo load() con un'istanza URLRequest:


import fl.containers.UILoader;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";
var req:URLRequest = new URLRequest(url);

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.move(10, 10);
myUILoader.load(req);
addChild(myUILoader);

loadBytes

()

metodo

public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Carica dai dati binari memorizzati in un oggetto ByteArray.

Parametri

	`bytes:ByteArray` — Un oggetto ByteArray che contiene un file che ha uno qualunque dei formati di file supportati dalla classe ProLoader: SWF, GIF, JPEG o PNG.

	`context:LoaderContext` (default = `null`) — Solo la proprietà `applicationDomain` dell'oggetto LoaderContext è applicabile, mentre le proprietà `checkPolicyFile` e `securityDomain` non lo sono.

Genera

	`ArgumentError` — La proprietà `length` dell'oggetto ByteArray è 0.

	`IllegalOperationError` — La proprietà `checkPolicyFile` o `securityDomain` del parametro `context` è diversa da null.

	`SecurityError` — La proprietà `applicationDomain` della proprietà `context` viene fornita da un dominio non consentito.

Elementi API correlati

source
ProLoader.loadBytes()
LoaderContext

Esempio ( Come utilizzare questo esempio )

L'esempio seguente carica i byte originari di un file GIF in un oggetto UILoader:

import fl.containers.UILoader;

var imageBytes:Array = [ 71, 73, 70, 56, 57, 97, 50, 0, 30, 0, 230, 0, 0, 0, 0, 0, 173, 169, 206, 82, 73, 153, 74, 74, 74, 115, 109, 155, 248, 247, 251, 102, 102, 102, 26, 24, 35, 181, 181, 181, 70, 61, 145, 222, 222, 222, 153, 153, 153, 204, 204, 204, 58, 58, 58, 132, 132, 132, 231, 231, 231, 8, 7, 14, 90, 90, 90, 89, 81, 163, 153, 153, 153, 191, 188, 217, 165, 165, 165, 190, 190, 190, 237, 237, 233, 51, 51, 51, 214, 214, 214, 90, 82, 156, 156, 152, 190, 123, 123, 123, 140, 140, 140, 140, 135, 187, 103, 96, 165, 78, 70, 150, 173, 173, 173, 127, 121, 179, 82, 82, 82, 206, 204, 226, 195, 195, 193, 102, 102, 102, 247, 247, 247, 41, 41, 41, 66, 66, 66, 183, 179, 212, 146, 141, 190, 21, 21, 20, 227, 226, 238, 119, 111, 181, 198, 195, 221, 99, 91, 162, 255, 255, 255, 218, 216, 233, 114, 114, 114, 16, 15, 27, 114, 107, 171, 210, 208, 228, 8, 8, 8, 179, 175, 209, 240, 239, 246, 153, 153, 153, 234, 233, 243, 95, 88, 160, 90, 74, 156, 33, 33, 33, 16, 16, 16, 163, 159, 200, 142, 137, 188, 197, 189, 222, 134, 129, 183, 151, 147, 193, 202, 199, 223, 222, 221, 235, 122, 115, 176, 215, 213, 231, 74, 66, 147, 82, 75, 146, 197, 197, 197, 106, 99, 166, 231, 230, 240, 175, 171, 207, 239, 239, 239, 209, 207, 227, 25, 25, 22, 119, 112, 182, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 33, 249, 4, 0, 7, 0, 255, 0, 44, 0, 0, 0, 0, 50, 0, 30, 0, 0, 7, 255, 128, 49, 130, 131, 132, 132, 8, 24, 0, 16, 6, 15, 133, 141, 5, 54, 69, 77, 141, 147, 148, 147, 51, 63, 0, 153, 0, 40, 8, 148, 5, 1, 53, 48, 48, 31, 30, 50, 149, 167, 133, 5, 41, 154, 172, 0, 33, 141, 59, 76, 9, 2, 26, 181, 32, 32, 42, 168, 168, 170, 173, 172, 63, 23, 132, 59, 31, 32, 181, 197, 181, 73, 185, 186, 147, 5, 3, 189, 173, 29, 131, 194, 196, 198, 198, 184, 202, 141, 205, 206, 172, 35, 130, 77, 195, 212, 224, 73, 56, 215, 131, 217, 218, 154, 41, 49, 222, 211, 224, 212, 226, 228, 230, 231, 153, 6, 5, 223, 237, 237, 239, 186, 241, 242, 0, 11, 46, 236, 247, 194, 5, 64, 181, 79, 222, 129, 15, 180, 2, 6, 76, 226, 164, 82, 193, 115, 52, 148, 72, 80, 72, 145, 225, 164, 135, 218, 34, 242, 160, 200, 145, 225, 133, 12, 229, 248, 177, 210, 200, 177, 36, 136, 13, 140, 98, 112, 16, 169, 9, 130, 146, 141, 37, 75, 38, 121, 17, 195, 2, 38, 150, 81, 8, 76, 228, 40, 160, 39, 79, 38, 77, 26, 176, 4, 192, 130, 129, 148, 132, 10, 147, 0, 65, 162, 1, 169, 194, 32, 67, 127, 100, 40, 224, 244, 94, 18, 34, 130, 108, 248, 228, 200, 242, 7, 131, 24, 70, 170, 134, 91, 65, 8, 202, 86, 133, 17, 248, 121, 21, 148, 131, 135, 216, 98, 73, 255, 130, 52, 42, 114, 182, 157, 8, 5, 62, 206, 173, 29, 228, 33, 137, 85, 15, 148, 232, 190, 213, 0, 195, 84, 5, 109, 123, 7, 181, 104, 26, 110, 200, 169, 23, 32, 196, 38, 24, 40, 168, 195, 141, 86, 40, 190, 54, 34, 161, 33, 73, 207, 158, 73, 0, 163, 122, 33, 192, 115, 79, 16, 87, 11, 101, 152, 209, 0, 195, 128, 5, 39, 42, 237, 32, 194, 132, 7, 143, 35, 20, 174, 181, 88, 241, 193, 182, 8, 154, 228, 42, 229, 200, 17, 188, 184, 241, 224, 29, 150, 148, 0, 25, 35, 67, 133, 24, 39, 20, 44, 89, 18, 3, 1, 243, 37, 8, 136, 215, 68, 112, 34, 250, 146, 39, 5, 16, 88, 16, 36, 125, 73, 120, 230, 25, 16, 164, 44, 81, 194, 0, 2, 235, 5, 44, 116, 232, 244, 0, 67, 135, 8, 41, 58, 52, 200, 80, 194, 129, 131, 1, 49, 204, 48, 195, 2, 6, 224, 197, 65, 6, 35, 44, 192, 193, 12, 57, 160, 112, 95, 126, 13, 40, 16, 130, 1, 21, 140, 144, 129, 3, 51, 84, 128, 194, 18, 28, 148, 32, 31, 7, 6, 196, 160, 64, 4, 49, 44, 65, 162, 3, 11, 88, 128, 98, 10, 10, 164, 35, 72, 6, 0, 46, 48, 131, 32, 3, 88, 64, 98, 123, 42, 85, 136, 226, 12, 29, 112, 163, 146, 5, 28, 88, 16, 66, 7, 11, 0, 56, 98, 77, 33, 162, 56, 194, 88, 18, 10, 52, 240, 64, 4, 22, 40, 208, 1, 3, 36, 50, 48, 130, 116, 17, 28, 9, 100, 12, 14, 132, 224, 64, 7, 82, 142, 168, 94, 10, 37, 112, 16, 66, 10, 25, 48, 144, 194, 5, 90, 38, 89, 193, 2, 40, 140, 128, 65, 5, 12, 248, 224, 3, 7, 79, 10, 226, 128, 157, 37, 156, 192, 141, 5, 51, 114, 80, 193, 19, 24, 196, 121, 66, 157, 173, 49, 208, 161, 3, 40, 68, 208, 0, 7, 129, 0, 0, 59 ];

var totalBytes:uint = imageBytes.length;
var newBytes:ByteArray = new ByteArray()
var i:uint;
for(i=0; i<totalBytes; i++) {
    newBytes.writeByte(imageBytes[i]);
}

var loader:UILoader = new UILoader();
loader.loadBytes(newBytes);
addChild(loader);

setSize

()

metodo

override public function setSize(w:Number, h:Number):void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Ridimensiona il componente in base alle dimensioni richieste. Se la proprietà scaleContent è impostata su true, il ridimensionamento di UILoader non viene effettuato.

Parametri

	`w:Number` — La larghezza del componente, espressa in pixel.

	`h:Number` — L'altezza del componente, espressa in pixel.

Elementi API correlati

scaleContent

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un'istanza del componente UILoader e la ridimensiona sullo stage utilizzando il metodo setSize():


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
addChild(myUILoader);

function completeHandler(event:Event):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var image:DisplayObject = uiLdr.content as DisplayObject;
    trace("UILoader:", uiLdr.width, uiLdr.height); // 100 100
    trace("UILoader.content:", image.width, image.height); // 400 267
    uiLdr.setSize(image.width, image.height);
    uiLdr.move((stage.stageWidth - image.width) / 2, (stage.stageHeight - image.height) / 2);
}

unload

()

metodo

public function unload():void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Rimuove un elemento secondario di questo oggetto UILoader caricato mediante il metodo load() o la proprietà source.

Elementi API correlati

load()
source

Esempio ( Come utilizzare questo esempio )

L'esempio seguente carica un'immagine in un componente UILoader e scarica l'immagine caricata quando viene inviato l'evento click del componente UILoader:


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 10);
myUILoader.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myUILoader);

function clickHandler(event:MouseEvent):void {
    var uil:UILoader = event.currentTarget as UILoader;
    uil.unload();
    removeChild(uil);
}

Descrizione degli eventi

complete

Evento

Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.COMPLETE

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Inviato quando il caricamento del contenuto è completato. Questo evento viene inviato a prescindere che il caricamento sia stato attivato da un processo di caricamento automatico o da una chiamata esplicita al metodo load().

La costante Event.COMPLETE definisce il valore della proprietà type di un oggetto evento complete.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto di rete che ha completato il caricamento.

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un'istanza UILoader e al termine del caricamento dell'immagine specificata, centra l'immagine sullo stage:


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
addChild(myUILoader);

function completeHandler(event:Event):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var newX:uint = (stage.stageWidth - uiLdr.content.width) / 2;
    var newY:uint = (stage.stageHeight - uiLdr.content.height) / 2;
    uiLdr.move(newX, newY);
}

Elementi API correlati

progress

init

Evento

Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.INIT

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Inviato quando le proprietà e i metodi di un file SWF caricato sono accessibili. Questo evento viene inviato in presenza delle condizioni seguenti:

Tutte le proprietà e i metodi associati all'oggetto caricato e al componente devono essere accessibili.
Le funzioni di costruzione di tutti gli oggetti secondari devono essere state completate.

La costante Event.INIT definisce il valore della proprietà type di un oggetto evento init.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto LoaderInfo associato al file SWF che viene caricato.

ioError

Evento

Tipo di oggetto evento: flash.events.IOErrorEvent
proprietà IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Inviato quando si verifica un errore di input o di output.

Definisce il valore della proprietà type di un oggetto evento ioError.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`errorID`	Un numero di riferimento associato all'errore specifico (solo AIR).
`target`	L'oggetto di rete interessato dall'errore di input/output.
`text`	Testo da visualizzare come messaggio di errore.

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un'istanza del componente UILoader e tenta di caricare un file inesistente, causando l'invio dell'evento ioError:


import fl.containers.UILoader;

var url:String = "http://www.helpexamples.com/flash/images/image404.jpg"

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.move(10, 10);
myUILoader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
addChild(myUILoader);

function ioErrorHandler(event:IOErrorEvent):void {
    trace("<<", event.text, ">>");
    myUILoader.removeEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
    removeChild(myUILoader);
}

open

Evento

Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.OPEN

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Inviato dopo l'inizio di un'operazione di rete.

La costante Event.OPEN definisce il valore della proprietà type di un oggetto evento open.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto di rete che ha aperto una connessione.

progress

Evento

Tipo di oggetto evento: flash.events.ProgressEvent
proprietà ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Inviato quando il contenuto è in fase di caricamento. Questo evento viene inviato a prescindere che il caricamento sia stato attivato da un processo di caricamento automatico o da una chiamata esplicita al metodo load().

Definisce il valore della proprietà type di un oggetto evento progress.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`bytesLoaded`	Il numero di elementi o di byte caricati nel momento in cui il listener elabora l'evento.
`bytesTotal`	Il numero totale di elementi o byte che vengono caricati se il processo di caricamento viene completato correttamente.
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto che riporta l'avanzamento.

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un'istanza del componente UILoader, che visualizza un'immagine caricata, e istanze dei componenti ProgressBar e Label, che mostrano lo stato dello scaricamento dell'immagine:


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

Elementi API correlati

complete

resize

Evento

Tipo di oggetto evento: fl.events.ComponentEvent
proprietà ComponentEvent.type = fl.events.ComponentEvent.RESIZE

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Inviato dopo che il componente viene ridimensionato.

Definisce il valore della proprietà type di un oggetto evento resize.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto event con un listener di eventi.
`target`	L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà `currentTarget` per accedere all'oggetto che intercetta l'evento.

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un'istanza del componente UILoader, intercetta l'evento resize e centra l'immagine sullo stage al termine del caricamento:


import fl.containers.UILoader;
import fl.events.ComponentEvent;

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.addEventListener(ComponentEvent.RESIZE, resizeHandler);
addChild(myUILoader);

function resizeHandler(event:ComponentEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    trace(uiLdr.width, uiLdr.height); // 400 267
    uiLdr.move((stage.stageWidth - uiLdr.width) / 2, (stage.stageHeight - uiLdr.height) / 2);
}

securityError

Evento

Tipo di oggetto evento: flash.events.SecurityErrorEvent
proprietà SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Inviato dopo che si è verificato un errore di sicurezza durante il caricamento del contenuto.

La costante SecurityErrorEvent.SECURITY_ERROR definisce il valore della proprietà type di un oggetto evento securityError.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto di rete che riporta l'errore di sicurezza.
`text`	Testo da visualizzare come messaggio di errore.

Esempi Come utilizzare questo esempio

UILoaderExample.as

Questo esempio illustra una semplice interazione con la classe UILoader.

Collocate un'istanza di UILoader sullo stage e denominatela "uiLoader".
Collocate un'istanza di Label al di sopra dell'istanza UILoader e denominatela "uiLoaderLabel".
Salvate questo codice come UILoaderExample.as nella stessa directory del FLA.
Impostate DocumentClass nel FLA su UILoaderExample.

package
{
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.events.Event;
    import flash.events.ProgressEvent;

    public class UILoaderExample extends Sprite
    {
        private var sampleImagePath:String = "test.jpg";
        
        public function UILoaderExample() {
            var request:URLRequest = new URLRequest(sampleImagePath);
            uiLoader.scaleContent = false;
            uiLoader.addEventListener(Event.COMPLETE,loadComplete);
            uiLoader.addEventListener(ProgressEvent.PROGRESS,loadProgress);            
            uiLoader.load(request);
        }
        private function loadProgress(e:ProgressEvent):void {
            uiLoaderLabel.text = String(e.target.percentLoaded);
        }
        private function loadComplete(e:Event):void {
            uiLoaderLabel.text = "Load Complete";    
        }
    }
}

Note legali | Informativa sulla privacy online

UILoader - AS3 Flash

Classi x

autoLoad

bytesLoaded

bytesTotal

content

maintainAspectRatio

percentLoaded

scaleContent

source

UILoader

close

getStyleDefinition

load

loadBytes

setSize

unload

complete

init

ioError

open

progress

resize

securityError