fl.video.FLVPlaybackCaptioning (ActionScript 3.0)

	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
		autoLayout: Boolean Determina se il componente FLVPlaybackCaptioning sposta e ridimensiona automaticamente l'oggetto TextField per le didascalie.	FLVPlaybackCaptioning
		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
		captionButton: Sprite Definisce l'istanza del componente dell'interfaccia utente personalizzata FLVPlayback captionButton che fornisce funzionalità in grado di attivare e disattivare le didascalie.	FLVPlaybackCaptioning
		captionTarget: DisplayObject Imposta l'istanza DisplayObject in cui visualizzare le didascalie.	FLVPlaybackCaptioning
		captionTargetName: String Il nome dell'istanza dell'oggetto TextField o MovieClip che racchiude un oggetto Textfield contenente le didascalie.	FLVPlaybackCaptioning
		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
		doubleClickEnabled: Boolean Specifica se l'oggetto riceve gli eventi doubleClick.	InteractiveObject
		dropTarget: DisplayObject [sola lettura] Specifica l'oggetto di visualizzazione sopra il quale viene trascinato lo sprite o sul quale viene rilasciato.	Sprite
		filters: Array Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione.	DisplayObject
		flvPlayback: FLVPlayback Imposta l'istanza FLVPlayback a cui aggiungere le didascalie.	FLVPlaybackCaptioning
		flvPlaybackName: String Imposta un nome per l'istanza FLVPlayback a cui si desidera aggiungere le didascalie.	FLVPlaybackCaptioning
		focusRect: Object Specifica se l'oggetto visualizza un rettangolo di attivazione.	InteractiveObject
		graphics: Graphics [sola lettura] Specifica l'oggetto Graphics che appartiene a questo oggetto Sprite, in cui possono essere eseguiti i comandi di disegno vettoriale.	Sprite
		height: Number Indica l'altezza dell'oggetto di visualizzazione espressa in pixel.	DisplayObject
		hitArea: Sprite Definisce un altro sprite come area attiva di uno sprite.	Sprite
		loaderInfo: LoaderInfo [sola lettura] Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene.	DisplayObject
		mask: DisplayObject L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato.	DisplayObject
		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
		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
		scrollRect: Rectangle I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione.	DisplayObject
		showCaptions: Boolean Utilizzato per visualizzare le didascalie; true = visualizza didascalie, false = non visualizzare didascalie.	FLVPlaybackCaptioning
		simpleFormatting: Boolean Limita le istruzioni di formattazione provenienti dal file Timed Text, se impostato su true.	FLVPlaybackCaptioning
		soundTransform: SoundTransform Controlla il suono nello sprite.	Sprite
		source: String URL del file Timed Text XML che contiene le informazioni sulle didascalie (proprietà required).	FLVPlaybackCaptioning
		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
		track: uint Supporto di tracce di lingua multiple.	FLVPlaybackCaptioning
		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
		videoPlayerIndex: uint Collega le didascalie a uno specifico VideoPlayer nel componente FLVPlayback.	FLVPlaybackCaptioning
		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

	Metodo	Definito da
		FLVPlaybackCaptioning() Crea una nuova istanza FLVPlaybackCaptioning.	FLVPlaybackCaptioning
		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
		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
		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
		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

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
captionChange	Inviato quando una didascalia viene aggiunta o rimossa dal campo di testo caption target.	FLVPlaybackCaptioning
captionTargetCreated	Inviato dopo la creazione della proprietà captionTarget, ma prima dell'aggiunta di didascalie (la proprietà captionTarget è vuota).	FLVPlaybackCaptioning
click	Inviato quando l'utente preme e rilascia il pulsante principale del dispositivo di puntamento sopra lo stesso InteractiveObject.	InteractiveObject
complete	Inviato dopo che tutti di dati Timed Text XML sono stati caricati.	FLVPlaybackCaptioning
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
httpStatus	Inviato se una chiamata a URLLoader.load() tenta di accedere a un file Timed Text XML via HTTP e l'ambiente Flash Player corrente è in grado di rilevare e restituire il codice di stato della richiesta.	FLVPlaybackCaptioning
ioError	Inviato se una chiamata all'evento URLLoader.load() provoca un errore fatale che termina lo scaricamento del file Timed Text XML.	FLVPlaybackCaptioning
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
open	Inviato quando viene avviata l'operazione di scaricamento necessaria per caricare il file Timed Text XML, in seguito a una chiamata al metodo URLLoader.load().	FLVPlaybackCaptioning
progress	Inviato quando vengono ricevuti dati durante lo scaricamento del file Timed Text XML.	FLVPlaybackCaptioning
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
securityError	Inviato se una chiamata all'evento URLLoader.load() tenta di caricare un file Timed Text XML da un server al di fuori della funzione di sicurezza sandbox.	FLVPlaybackCaptioning
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

	Costante	Definito da
		SHORT_VERSION: String = "2.0" [statico] Variabile di stato che indica il numero di versione breve del componente.	FLVPlaybackCaptioning
		VERSION: String = "2.0.0.34" [statico] Variabile di stato che indica il numero di versione lungo del componente.	FLVPlaybackCaptioning

Descrizione delle proprietà

autoLayout

proprietà

autoLayout:Boolean [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Determina se il componente FLVPlaybackCaptioning sposta e ridimensiona automaticamente l'oggetto TextField per le didascalie.

Se la proprietà autoLayout è impostata su true, l'istanza DisplayObject dell'oggetto TextField contenente le didascalie visualizza un'area di 10 pixel alla base dell'istanza FLVPlayback. L'area delle didascalie copre la larghezza dell'istanza FLVPlayback, mantenendo un margine di 10 pixel su ogni lato.

Se questa proprietà è impostata su true, l'istanza DisplayObject o l'oggetto TextField viene visualizzato direttamente sopra l'istanza FLVPlayback. Se si sta creando un proprio oggetto TextField, impostare autoLayout su false. Se wordWrap = false, l'area delle didascalie viene posizionata al centro sopra l'istanza FLVPlayback, ma può risultare più larga dell'istanza FLVPlayback.

Per controllare il layout, è necessario attivare un listener dell'evento captionChange per determinare se l'istanza dell'oggetto TextField è stata creata.

Il valore predefinito è true.

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

Vedere anche

captionTarget
Evento captionChange

captionButton

proprietà

captionButton:Sprite [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Definisce l'istanza del componente dell'interfaccia utente personalizzata FLVPlayback captionButton che fornisce funzionalità in grado di attivare e disattivare le didascalie.

La proprietà captionButton funziona in modo simile alle proprietà playButton, pauseButton, muteButton, ecc. di FLVPlayback.

Implementazione
public function get captionButton():Sprite
public function set captionButton(value:Sprite):void

Vedere anche

FLVPlayback

captionTarget

proprietà

captionTarget:DisplayObject [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Imposta l'istanza DisplayObject in cui visualizzare le didascalie.

Se si imposta l'istanza come un oggetto TextField, essa viene indirizzata direttamente. Se si imposta l'istanza come un DisplayObjectContainer contenente uno o più oggetti TextField, le didascalie vengono visualizzate nell'oggetto TextField con l'indice di visualizzazione più basso.

Il metodo DisplayObjectContainer supporta un oggetto simile a un clip filmato con uno sfondo scala 9, che può essere modificato in scala quando le dimensioni dell'oggetto TextField cambiano.

Per disegni e modifiche in scala più complessi, scrivere un codice che chiami il metodo DisplayObjectContainer come listener dell'evento captionChange.

Nota: se la proprietà captionTargetName o captionTarget non viene impostata, l'istanza FLVPlaybackCaptioning crea un campo di testo impostato dalla proprietà captionTarget con la seguente formattazione:

sfondo nero (background = true; backgroundColor = 0x000000;)
testo bianco (textColor = 0xFFFFFF)
autoSize = TextFieldAutoSize.LEFT
multiLine = true
wordWrap = true
font = "_sans"
size = 12

Per personalizzare questi valori, attivare un listener dell'evento captionTargetCreated.

Implementazione
public function get captionTarget():DisplayObject
public function set captionTarget(value:DisplayObject):void

Vedere anche

captionTargetName
flash.display.DisplayObjectContainer

captionTargetName

proprietà

captionTargetName:String [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Il nome dell'istanza dell'oggetto TextField o MovieClip che racchiude un oggetto Textfield contenente le didascalie.

Per non specificare alcun target, impostare questa proprietà su una stringa vuota (nessun target specificato) oppure su auto. Questa proprietà viene principalmente utilizzata nella finestra di ispezione dei componenti. Se si sta scrivendo del codice, usare invece la proprietà captionTarget.

Il valore predefinito è auto.

Implementazione
public function get captionTargetName():String
public function set captionTargetName(value:String):void

Vedere anche

captionTarget

flvPlayback

proprietà

flvPlayback:FLVPlayback [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Imposta l'istanza FLVPlayback a cui aggiungere le didascalie. L'istanza FLVPlayback deve avere lo stesso elemento principale dell'istanza FLVPlaybackCaptioning.

Se non si imposta né flvPlaybackName né flvPlayback, l'istanza FLVPlaybackCaptioning cerca un'istanza FLVPlayback con lo stesso elemento principale e aggiunge le didascalie al primo elemento che trova.

Implementazione
public function get flvPlayback():FLVPlayback
public function set flvPlayback(value:FLVPlayback):void

Vedere anche

flvPlaybackName

proprietà

flvPlaybackName:String [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Imposta un nome per l'istanza FLVPlayback a cui si desidera aggiungere le didascalie.

Per non specificare un target, impostare questa voce su una stringa vuota o su auto. L'istanza FLVPlayback deve avere lo stesso elemento principale dell'istanza FLVPlaybackCaptioning.

Il nome dell'istanza FLVPlayback viene principalmente utilizzato nella finestra di ispezione dei componenti. Se si sta scrivendo del codice, usare la proprietà flvPlayback.

Se la proprietà flvPlaybackName o flvPlayback non è impostata o è impostata su auto, l'istanza FLVPlaybackCaptioning cerca un'istanza FLVPlayback con lo stesso elemento principale e trasforma in didascalia la prima che trova.

Il valore predefinito è auto.

Implementazione
public function get flvPlaybackName():String
public function set flvPlaybackName(value:String):void

Vedere anche

Classe FLVPlayback
Proprietà flvPlayback

showCaptions

proprietà

showCaptions:Boolean [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Per visualizzare le didascalie; true = visualizza didascalie, false = non visualizzare didascalie.

Se si usa la proprietà captionButton per consentire all'utente di attivare/disattivare le didascalie, impostare la proprietà showCaptions su false.

Il valore predefinito è true.

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

Vedere anche

captionButton

simpleFormatting

proprietà

simpleFormatting:Boolean [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Limita le istruzioni di formattazione provenienti dal file Timed Text, se impostato su true.

I seguenti stili non sono supportati se la proprietà simpleFormatting è impostata su true:

tts:backgroundColor
tts:color
tts:fontSize
tts:fontFamily
tts:wrapOption

I seguenti stili sono supportati se la proprietà simpleFormatting è impostata su true:

tts:fontStyle
tts:fontWeight
tts:textAlign

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

source

proprietà

source:String [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

URL del file Timed Text XML che contiene le informazioni sulle didascalie (proprietà required).

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

track

proprietà

track:uint [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Supporto di tracce di lingua multiple.

Il miglior impiego della proprietà track è il supporto di tracce di lingua multiple con cue point incorporati.

Utilizzare i formati supportati per i cue point FLVPlaybackCaptioning.

Se la proprietà track è impostata su qualcosa di diverso da 0, il componente FLVPlaybackCaptioning cercherà una proprietà text<n> nel cue point, dove n corrisponde al valore di track.

Ad esempio, se track == 1, il componente FLVPlayBackCaptioning cercherà il parametro text1 sul cue point. Se non viene rilevato alcun parametro corrispondente, viene utilizzata la proprietà text del cue point.

Il valore predefinito è 0.

Implementazione
public function get track():uint
public function set track(value:uint):void

videoPlayerIndex

proprietà

videoPlayerIndex:uint [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Collega le didascalie a uno specifico VideoPlayer nel componente FLVPlayback.

Se si desidera utilizzare le didascalie in più lettori video (utilizzando le proprietà activeVideoPlayerIndex e visibleVideoPlayerIndex nel componente FLVPlayback), creare un'istanza del componente FLVPlaybackCaptioning per ogni VideoPlayer che si intende utilizzare e impostare questa proprietà in modo che corrisponda all'indice.

L'impostazione predefinita dell'indice di VideoPlayer è 0 se viene usato un solo lettore video.

Implementazione
public function get videoPlayerIndex():uint
public function set videoPlayerIndex(value:uint):void

Vedere anche

FLVPlayback.activeVideoPlayerIndex
FLVPlayback.visibleVideoPlayerIndex

Descrizione della funzione di costruzione

FLVPlaybackCaptioning

()

Funzione di costruzione

public function FLVPlaybackCaptioning()

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Crea una nuova istanza FLVPlaybackCaptioning.

Descrizione degli eventi

captionChange

Evento

Tipo di oggetto evento: fl.video.CaptionChangeEvent
CaptionChangeEvent.type property = fl.video.CaptionChangeEvent.CAPTION_CHANGE

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Inviato quando una didascalia viene aggiunta o rimossa dal campo di testo caption target.

L'evento viene anche inviato quando si verificano le seguenti condizioni:

la proprietà captionTargetName non è impostata.
la proprietà captionTarget non è impostata.
l'istanza FLVPlaybackCaptioning crea automaticamente un oggetto TextField per l'inserimento di didascalie.

L'evento captionChange presenta la costante CaptionChangeEvent.CAPTION_CHANGE.

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

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`added`	Un valore booleano che indica se la didascalia è stata aggiunta o rimossa.
`captionCuePointObject`	L'oggetto cue point di questa didascalia.

Vedere anche

captionTargetName
captionTarget

captionTargetCreated

Evento

Tipo di oggetto evento: fl.video.CaptionTargetEvent
CaptionTargetEvent.type property = fl.video.CaptionTargetEvent.CAPTION_TARGET_CREATED

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Inviato dopo la creazione della proprietà captionTarget, ma prima dell'aggiunta di didascalie (la proprietà captionTarget è vuota).

Se la proprietà captionTarget è impostata con un DisplayObject personalizzato oppure se la proprietà captionTargetName è impostata, questo evento non viene inviato.

Se si stanno personalizzando le proprietà dell'oggetto TextField, ad esempio, la proprietà defaultTextFormat, è necessario mettersi in ascolto di questo evento.

L'evento captionTargetCreated presenta la costante CaptionTargetEvent.CAPTION_TARGET_CREATED.

La costante CaptionTargetEvent.CAPTION_TARGET_CREATED definisce il valore della proprietà type di un oggetto evento captionTargetCreated.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`captionTarget`	Un oggetto di visualizzazione che proviene dalla proprietà `captionTarget` dell'istanza FLVPlaybackCaptioning.

Vedere anche

captionTargetName
captionTarget
flash.display.DisplayObject

complete

Evento

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

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Inviato dopo che tutti di dati Timed Text XML sono stati caricati.

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.

Vedere anche

Evento URLLoader.complete

httpStatus

Evento

Tipo di oggetto evento: flash.events.HTTPStatusEvent
HTTPStatusEvent.type property = flash.events.HTTPStatusEvent.HTTP_STATUS

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Inviato se una chiamata a URLLoader.load() tenta di accedere a un file Timed Text XML via HTTP e l'ambiente Flash Player corrente è in grado di rilevare e restituire il codice di stato della richiesta.

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

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.
`status`	Il codice di stato HTTP restituito dal server.
`target`	L'oggetto di rete che riceve un codice di stato HTTP.

Vedere anche

Evento URLLoader.httpStatus

ioError

Evento

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

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Inviato se una chiamata all'evento URLLoader.load() provoca un errore fatale che termina lo scaricamento del file Timed Text XML.

Se questo evento non viene gestito, viene generato un errore.

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.
`target`	L'oggetto di rete interessato dall'errore di input/output.
`text`	Testo da visualizzare come messaggio di errore.

Vedere anche

Evento URLLoader.ioError

open

Evento

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

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Inviato quando viene avviata l'operazione di scaricamento necessaria per caricare il file Timed Text XML, in seguito a una chiamata al metodo URLLoader.load().

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.

Vedere anche

Evento URLLoader.open

progress

Evento

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

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Inviato quando vengono ricevuti dati durante lo scaricamento del file Timed Text XML.

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 di rete che riporta l'avanzamento.

Vedere anche

Evento URLLoader.progress

securityError

Evento

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

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Inviato se una chiamata all'evento URLLoader.load() tenta di caricare un file Timed Text XML da un server al di fuori della funzione di sicurezza sandbox.

Se questo evento non viene gestito, viene generato un errore.

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.

Vedere anche

Evento URLLoader.securityError

Descrizione delle costanti

SHORT_VERSION

Costante

public static const SHORT_VERSION:String = "2.0"

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Variabile di stato che indica il numero di versione breve del componente. Il numero di versione è utile quando si dispone di un file FLA e si desidera conoscere la versione del componente. Per determinare la versione del componente, digitare la seguente traccia di codice nel file FLA:

trace (FLVPlaybackCaptioning.SHORT_VERSION);

La variabile SHORT_VERSION include unicamente i numeri di versione principale e minore, ad esempio 2.0. La variabile version include i numeri di versione principali e minori, così come i numeri di revisione e di build, ad esempio, 2.0.0.xx.

Vedere anche

Variabile VERSION

VERSION

Costante

public static const VERSION:String = "2.0.0.34"

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.0

Variabile di stato che indica il numero di versione lungo del componente. Il numero di versione è utile quando si dispone di un file FLA e si desidera conoscere la versione del componente. Per determinare la versione del componente, digitare la seguente traccia di codice nel file FLA:

trace (FLVPlaybackCaptioning.VERSION);

La variabile VERSION include i numeri di versione principali e minori, così come i numeri di revisione e di build, ad esempio, 2.0.0.xx. La variabile SHORT_VERSION include unicamente i numeri di versione principale e minore, ad esempio 2.0.

Vedere anche

Variabile SHORT_VERSION

Esempi Come utilizzare gli esempi

FLVPlaybackCaptioningExample.as

L'esempio seguente illustra come creare dinamicamente un'istanza FLVPlayback con didascalie selezionabili.

Per provare l'esempio, eseguire queste operazioni:

Collocare il componente FLVPlayback sullo stage in posizione 0,0 e fornire il nome di istanza player.
Collocare il componente FLVPlaybackCaptioning sullo stage in posizione 0,0 e fornire il nome di istanza captioning.
Posizionare il componente CaptionButton sullo stage.
Impostare videoPath su un percorso assoluto o relativo a un file FLV.
Impostare captioningPath su un percorso assoluto o relativo a un file Timed Text XML appropriato.
Aggiungere i componenti FLVPlayback e FLVPlaybackCaptioning alla libreria.
Salvare il codice come FLVPlaybackCaptioningExample.as nella stessa directory del file FLA.
Impostare la classe documento nel file FLA su FLVPlaybackCaptioningExample.

package
{
    import fl.video.CaptionChangeEvent;
    import fl.video.FLVPlayback;
    import fl.video.FLVPlaybackCaptioning;
    import flash.display.Sprite;
    import flash.text.TextField;
    
    public class FLVPlaybackCaptioningExample extends Sprite {

        private var videoPath:String = "http://www.helpexamples.com/flash/video/caption_video.flv";
        private var captioningPath:String = "http://www.helpexamples.com/flash/video/caption_video.xml";
        
        public function FLVPlaybackCaptioningExample() {
            player.source = videoPath;
            player.skin = "SkinOverAllNoCaption.swf";
            player.skinBackgroundColor = 0x666666;
            player.skinBackgroundAlpha = 0.5;

            captioning.flvPlayback = player;
            captioning.source = captioningPath;
            captioning.autoLayout = false;            
            captioning.addEventListener(CaptionChangeEvent.CAPTION_CHANGE, onCaptionChange);
        }

        private function onCaptionChange(e:CaptionChangeEvent):void {
            var tf:* = e.target.captionTarget;
            var player:FLVPlayback = e.target.flvPlayback;

            // move the caption below the video
            tf.y = 210;            
        }
    }
}

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/fl/video/FLVPlaybackCaptioning.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
FLVPlaybackCaptioning	Proprietà \| Metodi \| Eventi \| Costanti \| Esempi

Pacchetto	fl.video
Classe	public class FLVPlaybackCaptioning
Ereditarietà	FLVPlaybackCaptioning Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object