fl.livepreview.LivePreviewParent (ActionScript 3.0)

Pacchetto	fl.livepreview
Classe	public class LivePreviewParent
Ereditarietà	LivePreviewParent MovieClip Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

La classe LivePreviewParent fornisce la linea temporale per un file SWC o per un clip compilato da esportare quando si seleziona ActionScript 3.0.

Quando viene impostata una proprietà di un'istanza di componente o un'istanza di componente viene ridimensionata sullo stage, Flash effettua chiamate ai metodi di questa classe che, a loro volta, chiamano i metodi del codice del componente per impostare le proprietà e per ridimensionare il componente.

Nei casi in cui il componente deve implementare un'azione specifica quando si trova in modalità anteprima dal vivo, utilizzare il codice seguente per testare tale modalità:

var isLivePreview:Boolean = (parent != null && getQualifiedClassName(parent) == "fl.livepreview::LivePreviewParent");

La classe LivePreviewParent supporta la definizione di un metodo setSize() che impiega i valori width e height per ridimensionare il componente. Se non si definisce un metodo setSize(), questo oggetto imposta le proprietà width e height singolarmente.

Quando l'utente ridimensiona l'anteprima dal vivo del componente nello strumento di creazione di Flash, Flash tenta di chiamare il metodo setSize() del componente per l'anteprima. Se il componente non definisce un metodo setSize(), l'istanza della classe LivePreviewParent imposta le proprietà di larghezza e altezza del componente singolarmente.

Il modo più semplice per visualizzare un file di anteprima dal vivo di un componente è creare un file SWC ed estrarlo:

Esportare il componente come file SWC.
Modificare l'estensione file .swc in .zip.
Estrarre il file SWF dal file ZIP.

In alternativa, è possibile utilizzare la classe LivePreviewParent per creare un file SWF di anteprima dal vivo personalizzato senza creare un file SWC. Per creare un file di anteprima dal vivo di un componente, procedere come segue:"

Creare un nuovo documento Flash.
Impostare la relativa classe documento su fl.livepreview.LivePreviewParent.
Trascinare il componente sullo stage e posizionarlo in corrispondenza delle coordinate x e y pari a 0.
Verificare che i parametri del componente rimangano sulle impostazioni predefinite. Dovrebbe essere così se si trascina il componente dal pannello Libreria o Componenti.
Selezionare Elabora > Documento nel menu principale e, in corrispondenza dell'opzione Adatta, fare clic su Contenuto.
Fare clic su OK.
Pubblicare il file per visualizzare il file SWF risultante come file SWF di anteprima dal vivo personalizzato.
Nel pannello Libreria, fare clic con il pulsante destro del mouse sulla risorsa, quindi selezionare Definizione del componente dal menu di scelta rapida.
La finestra di dialogo Definizione del componente consente di specificare un file SWF di anteprima dal vivo personalizzato per un componente.

In alcuni casi, potrebbe essere necessario creare un file SWF di anteprima dal vivo personalizzato completamente diverso dal componente. Per un esempio, vedere l'anteprima dal vivo del componente fl.containers.UILoader. Questa anteprima dal vivo non usa le proprietà di UILoader, né implementa funzioni getter e setter per tali proprietà. Viene tuttavia implementato il metodo setSize() che impiega i parametri width e height per disegnare il componente con le nuove dimensioni.

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		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
		buttonMode: Boolean Specifica la modalità pulsante di questo sprite.	Sprite
		cacheAsBitmap: Boolean Se è impostata su true, viene memorizzata nella cache una rappresentazione bitmap interna dell'oggetto di visualizzazione.	DisplayObject
		constructor: Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		contextMenu: ContextMenu Specifica il menu di scelta rapida associato all'oggetto.	InteractiveObject
		currentFrame: int [sola lettura] Specifica il numero del fotogramma della linea temporale dell'istanza MovieClip in cui si trova l'indicatore di riproduzione.	MovieClip
		currentLabel: String [sola lettura] L'etichetta corrente della linea temporale dell'istanza MovieClip in cui si trova l'indicatore di riproduzione.	MovieClip
		currentLabels: Array [sola lettura] Restituisce un array di oggetti FrameLabel della scena corrente.	MovieClip
		currentScene: Scene [sola lettura] La scena corrente della linea temporale dell'istanza MovieClip in cui si trova l'indicatore di riproduzione.	MovieClip
		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 Un valore booleano che indica se un clip filmato è attivo.	MovieClip
		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
		framesLoaded: int [sola lettura] Il numero di fotogrammi caricati da un file SWF in streaming.	MovieClip
		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
		mouseChildren: Boolean Determina se gli elementi secondari dell'oggetto sono abilitati per il mouse o meno.	DisplayObjectContainer
		mouseEnabled: Boolean Specifica se l'oggetto riceve i messaggi relativi al mouse.	InteractiveObject
		mouseX: Number [sola lettura] Indica la coordinata x della posizione del mouse, in pixel.	DisplayObject
		mouseY: Number [sola lettura] Indica la coordinata y della posizione del mouse, in pixel.	DisplayObject
		myInstance: DisplayObject L'istanza del componente associata all'anteprima dal vivo.	LivePreviewParent
		name: String Indica il nome dell'istanza dell'oggetto DisplayObject.	DisplayObject
		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
		prototype: Object [statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.	Object
		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
		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
		scenes: Array [sola lettura] Un array di oggetti Scene, ciascuno con nome, numero di fotogrammi e etichette dei fotogrammi per una scena dell'istanza MovieClip.	MovieClip
		scrollRect: Rectangle I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione.	DisplayObject
		soundTransform: 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: TextSnapshot [sola lettura] Restituisce un oggetto TextSnapshot per questa istanza DisplayObjectContainer.	DisplayObjectContainer
		totalFrames: int [sola lettura] Il numero totale di fotogrammi dell'istanza MovieClip.	MovieClip
		trackAsMenu: Boolean Indica se altri oggetti di visualizzazione del tipo SimpleButton o MovieClip possono ricevere gli eventi di rilascio del mouse.	MovieClip
		transform: 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 puntatore a forma di mano quando il mouse 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

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		LivePreviewParent() Inizializza la scala e allinea le modalità dello stage, imposta la proprietà myInstance, ridimensiona myInstance in modo adeguato e impiega la classe ExternalInterface per esporre le funzioni a Flash.	LivePreviewParent
		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 point specificato.	DisplayObjectContainer
		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
		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
		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
		globalToLocal(point:Point):Point Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point.	DisplayObject
		gotoAndPlay(frame:Object, scene:String = null):void Avvia la riproduzione del file SWF dal fotogramma specificato.	MovieClip
		gotoAndStop(frame:Object, scene:String = null):void Posiziona l'indicatore di riproduzione sul fotogramma specificato del clip filmato.	MovieClip
		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 l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con l'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
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		localToGlobal(point:Point):Point Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point.	DisplayObject
		nextFrame():void Invia l'indicatore di riproduzione al fotogramma successivo e lo interrompe.	MovieClip
		nextScene():void Sposta l'indicatore di riproduzione sulla scena successiva dell'istanza MovieClip.	MovieClip
		onResize(width:Number, height:Number):void Ridimensiona l'istanza del componente sullo stage in base alle dimensioni specificate, chiamando un metodo definito dall'utente o impostando separatamente le proprietà width e height.	LivePreviewParent
		onUpdate(... updateArray):void Aggiorna le proprietà dell'istanza del componente.	LivePreviewParent
		play():void Sposta l'indicatore di riproduzione nella linea temporale del clip filmato.	MovieClip
		prevFrame():void Invia l'indicatore di riproduzione al fotogramma precedente e lo interrompe.	MovieClip
		prevScene():void Sposta l'indicatore di riproduzione sulla scena precedente dell'istanza MovieClip.	MovieClip
		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
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setChildIndex(child:DisplayObject, index:int):void Cambia la posizione di un elemento secondario nel contenitore di oggetto di visualizzazione.	DisplayObjectContainer
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Consente all'utente di trascinare lo sprite specificato.	Sprite
		stop():void Ferma l'indicatore di riproduzione nel clip filmato.	MovieClip
		stopDrag():void Termina il metodo startDrag().	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
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		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

Eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	Inviato quando Flash Player riceve lo stato di attivazione del sistema operativo e diventa 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
click	Inviato quando l'utente preme e rilascia il pulsante principale del dispositivo di puntamento sopra lo stesso InteractiveObject.	InteractiveObject
deactivate	Inviato quando Flash Player perde lo stato di attivazione del sistema operativo e sta per diventare 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	Inviato quando l'indicatore di riproduzione sta entrando in un nuovo fotogramma.	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
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
mouseDown	Inviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject nella finestra di Flash Player.	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 un utente muove un dispositivo di puntamento sopra un'istanza InteractiveObject nella finestra di Flash Player.	InteractiveObject
mouseUp	Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject nella finestra di Flash Player.	InteractiveObject
mouseWheel	Inviato quando la rotella del mouse viene fatta ruotare sopra un'istanza InteractiveObject nella finestra di Flash Player.	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	Inviato quando l'elenco di visualizzazione sta per essere aggiornato e sottoposto a rendering.	DisplayObject
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
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

Descrizione delle proprietà

myInstance

proprietà

public var myInstance:DisplayObject

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

L'istanza del componente associata all'anteprima dal vivo. Questa proprietà viene utilizzata internamente come riferimento all'istanza del componente. Per impostare questa proprietà non sono necessari sviluppatori di componenti, perché l'operazione viene eseguita automaticamente quando un'istanza di un componente viene posizionata sullo stage.

Descrizione della funzione di costruzione

LivePreviewParent

()

Funzione di costruzione

public function LivePreviewParent()

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Inizializza la scala e allinea le modalità dello stage, imposta la proprietà myInstance, ridimensiona myInstance in modo adeguato e impiega la classe ExternalInterface per esporre le funzioni a Flash.

Descrizione dei metodi

onResize

()

metodo

public function onResize(width:Number, height:Number):void

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Ridimensiona l'istanza del componente sullo stage in base alle dimensioni specificate, chiamando un metodo definito dall'utente o impostando separatamente le proprietà width e height.

Questo metodo viene chiamato dallo strumento di creazione di Flash.

Parametri

	`width:Number` — La nuova larghezza dell'istanza `myInstance`.

	`height:Number` — La nuova altezza dell'istanza `myInstance`.

onUpdate

()

metodo

public function onUpdate(... updateArray):void

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Aggiorna le proprietà dell'istanza del componente. Questo metodo viene chiamato dallo strumento di creazione di Flash quando il valore di una proprietà viene modificato. Questo metodo aggiorna tutte le proprietà di un componente, anche se non sono state modificate.

Parametri

... updateArray — Un array di nomi e valori di parametro.

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/fl/livepreview/LivePreviewParent.html

Guida di riferimento del linguaggio e dei componenti ActionScript 3.0		Tutti i pacchetti \| Tutte le classi \| Elementi del linguaggio \| Indice \| Appendici \| Convenzioni \| Con frame Senza frame
LivePreviewParent	Proprietà \| Metodi \| Eventi