Pacchettoflash.display
Classepublic dynamic class MovieClip
EreditarietàMovieClip Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Sottoclassi LivePreviewParent

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La classe MovieClip eredita dalle seguenti classi: Sprite, DisplayObjectContainer, InteractiveObject, DisplayObject e EventDispatcher.

A differenza di Sprite, un oggetto MovieClip ha una linea temporale.

I metodi della classe MovieClip forniscono la stessa funzionalità delle azioni che agiscono sui clip filmato. Esistono altri metodi che non hanno azioni equivalenti nella casella degli strumenti Azioni del pannello Azioni di Flash.

Non è possibile accedere alle istanze secondarie posizionate sullo stage dello strumento di creazione di Flash con il codice dall'interno della funzione di costruzione di un'istanza principale, perché le istanze secondarie non sono state create in quel punto nell'esecuzione del codice. Prima di potere accedere all'istanza secondaria, l'istanza principale deve invece creare l'istanza secondaria mediante codice o ritardare l'accesso a una funzione di callback che resta in ascolto finché l'istanza secondaria non invia l'evento Event.ADDED_TO_STAGE.

Se si modifica una qualunque delle seguenti proprietà di un oggetto MovieClip che contiene un'interpolazione di movimento, Flash Player ferma l'indicatore di riproduzione in quell'oggetto MovieClip: alpha, blendMode, filters, height, opaqueBackground, rotation, scaleX, scaleY, scale9Grid, scrollRect, transform, visible, width, x o y. L'indicatore di riproduzione non viene tuttavia fermato negli eventuali oggetti MovieClip secondari dell'oggetto MovieClip.

Vedere gli esempi

Vedere anche

Classi di visualizzazione di base
Elementi fondamentali dei clip filmato


Proprietà pubbliche
 ProprietàDefinito da
 InheritedaccessibilityProperties: AccessibilityProperties
Le opzioni di accessibilità correnti di questo oggetto di visualizzazione.
DisplayObject
 Inheritedalpha: Number
Indica il valore della trasparenza alfa dell'oggetto specificato.
DisplayObject
 InheritedblendMode: String
Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare.
DisplayObject
 InheritedbuttonMode: Boolean
Specifica la modalità pulsante di questo sprite.
Sprite
 InheritedcacheAsBitmap: Boolean
Se è impostata su true, viene memorizzata nella cache una rappresentazione bitmap interna dell'oggetto di visualizzazione.
DisplayObject
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
 InheritedcontextMenu: 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
 InheriteddoubleClickEnabled: Boolean
Specifica se l'oggetto riceve gli eventi doubleClick.
InteractiveObject
 InheriteddropTarget: 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
 Inheritedfilters: Array
Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione.
DisplayObject
 InheritedfocusRect: 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
 Inheritedgraphics: Graphics
[sola lettura] Specifica l'oggetto Graphics che appartiene a questo oggetto Sprite, in cui possono essere eseguiti i comandi di disegno vettoriale.
Sprite
 Inheritedheight: Number
Indica l'altezza dell'oggetto di visualizzazione espressa in pixel.
DisplayObject
 InheritedhitArea: Sprite
Definisce un altro sprite come area attiva di uno sprite.
Sprite
 InheritedloaderInfo: LoaderInfo
[sola lettura] Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene.
DisplayObject
 Inheritedmask: DisplayObject
L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato.
DisplayObject
 InheritedmouseChildren: Boolean
Determina se gli elementi secondari dell'oggetto sono abilitati per il mouse o meno.
DisplayObjectContainer
 InheritedmouseEnabled: Boolean
Specifica se l'oggetto riceve i messaggi relativi al mouse.
InteractiveObject
 InheritedmouseX: Number
[sola lettura] Indica la coordinata x della posizione del mouse, in pixel.
DisplayObject
 InheritedmouseY: Number
[sola lettura] Indica la coordinata y della posizione del mouse, in pixel.
DisplayObject
 Inheritedname: String
Indica il nome dell'istanza dell'oggetto DisplayObject.
DisplayObject
 InheritednumChildren: int
[sola lettura] Restituisce il numero di elementi secondari di questo oggetto.
DisplayObjectContainer
 InheritedopaqueBackground: Object
Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo.
DisplayObject
 Inheritedparent: DisplayObjectContainer
[sola lettura] Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione.
DisplayObject
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
 Inheritedroot: 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
 Inheritedrotation: Number
Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale.
DisplayObject
 Inheritedscale9Grid: Rectangle
La griglia di modifica in scala attualmente attiva.
DisplayObject
 InheritedscaleX: Number
Indica la scala orizzontale (percentuale) dell'oggetto applicata dal punto di registrazione.
DisplayObject
 InheritedscaleY: 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
 InheritedscrollRect: Rectangle
I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione.
DisplayObject
 InheritedsoundTransform: SoundTransform
Controlla il suono nello sprite.
Sprite
 Inheritedstage: Stage
[sola lettura] Lo stage dell'oggetto di visualizzazione.
DisplayObject
 InheritedtabChildren: Boolean
Determina se gli elementi secondari dell'oggetto sono abilitati per la tabulazione.
DisplayObjectContainer
 InheritedtabEnabled: Boolean
Specifica se questo oggetto è incluso nell'ordine di tabulazione.
InteractiveObject
 InheritedtabIndex: int
Specifica l'ordine di tabulazione degli oggetti in un file SWF.
InteractiveObject
 InheritedtextSnapshot: 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
 Inheritedtransform: Transform
Un oggetto con proprietà relative alla matrice, alla trasformazione del colore e ai limiti di pixel di un oggetto di visualizzazione.
DisplayObject
 InheriteduseHandCursor: 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
 Inheritedvisible: Boolean
Determina se l'oggetto di visualizzazione è visibile o meno.
DisplayObject
 Inheritedwidth: Number
Indica la larghezza dell'oggetto di visualizzazione espressa in pixel.
DisplayObject
 Inheritedx: Number
Indica la coordinata x dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale.
DisplayObject
 Inheritedy: Number
Indica la coordinata y dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale.
DisplayObject
Metodi pubblici
 MetodoDefinito da
  
Crea una nuova istanza MovieClip.
MovieClip
 Inherited
Aggiunge un'istanza secondaria DisplayObject a questa istanza DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Aggiunge un'istanza secondaria DisplayObject a questa istanza DisplayObjectContainer.
DisplayObjectContainer
 Inherited
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
 Inherited
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
 Inherited
Determina se l'oggetto di visualizzazione specificato è un elemento secondario dell'istanza DisplayObjectContainer oppure è l'istanza stessa.
DisplayObjectContainer
 Inherited
Invia un evento nel flusso di eventi.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace.
DisplayObject
 Inherited
Restituisce l'istanza dell'oggetto di visualizzazione secondario che si trova in corrispondenza della posizione di indice specificata.
DisplayObjectContainer
 Inherited
Restituisce l'oggetto di visualizzazione secondario al quale corrisponde il nome specificato.
DisplayObjectContainer
 Inherited
Restituisce la posizione di indice di un'istanza DisplayObject secondaria.
DisplayObjectContainer
 Inherited
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
 Inherited
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
 Inherited
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
 Inherited
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.
EventDispatcher
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con l'oggetto di visualizzazione obj.
DisplayObject
 Inherited
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
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point.
DisplayObject
  
Invia l'indicatore di riproduzione al fotogramma successivo e lo interrompe.
MovieClip
  
Sposta l'indicatore di riproduzione sulla scena successiva dell'istanza MovieClip.
MovieClip
  
Sposta l'indicatore di riproduzione nella linea temporale del clip filmato.
MovieClip
  
Invia l'indicatore di riproduzione al fotogramma precedente e lo interrompe.
MovieClip
  
Sposta l'indicatore di riproduzione sulla scena precedente dell'istanza MovieClip.
MovieClip
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Rimuove l'istanza DisplayObject secondaria specificata dall'elenco degli elementi secondari dell'istanza DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Rimuove un'istanza DisplayObject secondaria dalla posizione di indice specificata nell'elenco degli elementi secondari di DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Rimuove un listener dall'oggetto EventDispatcher.
EventDispatcher
 Inherited
Cambia la posizione di un elemento secondario nel contenitore di oggetto di visualizzazione.
DisplayObjectContainer
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Consente all'utente di trascinare lo sprite specificato.
Sprite
  
Ferma l'indicatore di riproduzione nel clip filmato.
MovieClip
 Inherited
Termina il metodo startDrag().
Sprite
 Inherited
Scambia lo z-order (ordine di profondità) degli oggetti secondari specificati.
DisplayObjectContainer
 Inherited
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
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
 Inherited
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.
EventDispatcher
Eventi
 Evento Riepilogo Definito da
 Inherited Inviato quando Flash Player riceve lo stato di attivazione del sistema operativo e diventa attivo.EventDispatcher
 Inherited Inviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione.DisplayObject
 Inherited 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
 Inherited Inviato quando l'utente preme e rilascia il pulsante principale del dispositivo di puntamento sopra lo stesso InteractiveObject.InteractiveObject
 Inherited Inviato quando Flash Player perde lo stato di attivazione del sistema operativo e sta per diventare inattivo.EventDispatcher
 Inherited 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
 Inherited Inviato quando l'indicatore di riproduzione sta entrando in un nuovo fotogramma.DisplayObject
 Inherited Inviato dopo che un oggetto di visualizzazione ha ricevuto lo stato di attivazione.InteractiveObject
 Inherited Inviato dopo che un oggetto di visualizzazione ha perso lo stato di attivazione.InteractiveObject
 Inherited Inviato quando l'utente preme un tasto.InteractiveObject
 Inherited Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando la tastiera.InteractiveObject
 Inherited Inviato quando l'utente rilascia un tasto.InteractiveObject
 Inherited Inviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject nella finestra di Flash Player.InteractiveObject
 Inherited Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando un dispositivo di puntamento.InteractiveObject
 Inherited Inviato quando l'utente sposta il dispositivo di puntamento mentre si trova sopra un'istanza InteractiveObject.InteractiveObject
 Inherited Inviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject.InteractiveObject
 Inherited Inviato quando un utente muove un dispositivo di puntamento sopra un'istanza InteractiveObject nella finestra di Flash Player.InteractiveObject
 Inherited Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject nella finestra di Flash Player.InteractiveObject
 Inherited Inviato quando la rotella del mouse viene fatta ruotare sopra un'istanza InteractiveObject nella finestra di Flash Player.InteractiveObject
 Inherited Inviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione.DisplayObject
 Inherited 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
 Inherited Inviato quando l'elenco di visualizzazione sta per essere aggiornato e sottoposto a rendering.DisplayObject
 Inherited Inviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject.InteractiveObject
 Inherited Inviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject.InteractiveObject
 Inherited Inviato quando cambia il valore del flag tabChildren dell'oggetto.InteractiveObject
 Inherited Inviato quando cambia il flag tabEnabled dell'oggetto.InteractiveObject
 Inherited Inviato quando cambia il valore della proprietà tabIndex dell'oggetto.InteractiveObject
Descrizione delle proprietà
currentFrameproprietà
currentFrame:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Specifica il numero del fotogramma della linea temporale dell'istanza MovieClip in cui si trova l'indicatore di riproduzione. Se il clip filmato comprende più scene, questo valore corrisponde al numero di fotogramma della scena corrente.


Implementazione
    public function get currentFrame():int

Esempio

Nel codice seguente vengono utilizzati il metodo gotoAndStop() e la proprietà currentFrame per indicare all'indicatore di riproduzione del clip filmato mc1 di avanzare di cinque fotogrammi rispetto alla posizione corrente e fermarsi:
mc1.gotoAndStop(mc1.currentFrame + 5);
currentLabelproprietà 
currentLabel:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

L'etichetta corrente della linea temporale dell'istanza MovieClip in cui si trova l'indicatore di riproduzione. Se il fotogramma corrente non ha un'etichetta, currentLabel è impostato sul nome del precedente fotogramma dotato di un'etichetta. Se il fotogramma corrente e quelli precedenti non includono un'etichetta, currentLabel restituisce null.


Implementazione
    public function get currentLabel():String

Esempio

Il codice seguente mostra come accedere alla proprietà currentLabel di un oggetto MovieClip di nome mc1:
trace(mc1.currentLabel);
currentLabelsproprietà 
currentLabels:Array  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Restituisce un array di oggetti FrameLabel della scena corrente. Se l'istanza MovieClip è priva di scene, l'array include tutte le etichette dei fotogrammi dell'intera istanza MovieClip.


Implementazione
    public function get currentLabels():Array

Vedere anche


Esempio

Il codice seguente mostra l'utilizzo della proprietà currentLabels di un oggetto MovieClip di nome mc1:
import flash.display.FrameLabel;
 
var labels:Array = mc1.currentLabels;

for (var i:uint = 0; i < labels.length; i++) {
    var label:FrameLabel = labels[i];
    trace("frame " + label.frame + ": " + label.name);
}
currentSceneproprietà 
currentScene:Scene  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La scena corrente della linea temporale dell'istanza MovieClip in cui si trova l'indicatore di riproduzione.


Implementazione
    public function get currentScene():Scene

Vedere anche


Esempio

Il codice seguente mostra l'utilizzo della proprietà currentScene di un oggetto MovieClip di nome mc1:
import flash.display.Scene;
 
var scene:Scene = mc1.currentScene;
trace(scene.name + ": " + scene.numFrames + " frames");
enabledproprietà 
enabled:Boolean  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un valore booleano che indica se un clip filmato è attivo. Il valore predefinito di enabled è true. Se enabled è impostato su false, i fotogrammi Sopra, Giù e Su vengono disabilitati. Il clip filmato continua a ricevere gli eventi (ad esempio, mouseDown, mouseUp, keyDown e keyUp).

La proprietà enabled regola solo le proprietà di un clip filmato simili a pulsanti. È possibile modificare la proprietà enabled in qualsiasi momento; il clip filmato modificato viene immediatamente abilitato o disabilitato. Se enabled è impostata su false, l'oggetto non viene incluso nell'ordine di tabulazione automatico.


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

Esempio

Il codice seguente mostra l'utilizzo della proprietà enabled per disabilitare le proprietà simili a pulsanti di un oggetto MovieClip di nome mc1:
mc1.enabled = false;
framesLoadedproprietà 
framesLoaded:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il numero di fotogrammi caricati da un file SWF in streaming. È possibile utilizzare la proprietà frameLoaded per determinare se il contenuto di un fotogramma specifico e tutti i fotogrammi che lo precedono sono stati caricati e sono disponibili a livello locale nel browser. È utile anche per monitorare lo scaricamento dei file SWF di grandi dimensioni. Ad esempio, è possibile visualizzare un messaggio che indica all'utente che il caricamento del file SWF continua finché non è terminato il caricamento di uno specifico fotogramma nel file SWF.

Se il clip filmato comprende più scene, la proprietà framesLoaded restituisce il numero di fotogrammi caricati per tutte le scene del clip filmato.


Implementazione
    public function get framesLoaded():int

Vedere anche


Esempio

Il codice seguente mostra come utilizzare la proprietà framesLoaded e la proprietà totalFrames per determinare se un oggetto MovieClip in streaming di nome mc1 è stato caricato completamente:
if (mc1.framesLoaded == mc1.totalFrames) {
    trace("OK.");
}
scenesproprietà 
scenes:Array  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un array di oggetti Scene, ciascuno con nome, numero di fotogrammi e etichette dei fotogrammi per una scena dell'istanza MovieClip.


Implementazione
    public function get scenes():Array

Vedere anche


Esempio

Il codice seguente mostra l'utilizzo della proprietà scenes di un oggetto MovieClip di nome mc1:
import flash.display.Scene;
 
for (var i:uint = 0; i < mc1.scenes.length; i++) {
    var scene:Scene = mc1.scenes[i];
    trace("scene " + scene.name + ": " + scene.numFrames + " frames");
}
totalFramesproprietà 
totalFrames:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il numero totale di fotogrammi dell'istanza MovieClip.

Se il clip filmato comprende più fotogrammi, la proprietà totalFrames restituisce il numero totale di fotogrammi di tutte le scene del clip filmato.


Implementazione
    public function get totalFrames():int

Esempio

Il codice seguente mostra l'utilizzo della proprietà totalFrames di un oggetto MovieClip di nome mc1:
 trace(mc1.totalFrames);
trackAsMenuproprietà 
trackAsMenu:Boolean  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se altri oggetti di visualizzazione del tipo SimpleButton o MovieClip possono ricevere gli eventi di rilascio del mouse. La proprietà trackAsMenu consente di creare menu. È possibile impostare la proprietà trackAsMenu su qualunque oggetto SimpleButton o MovieClip. Il valore predefinito della proprietà trackAsMenu è false.

È possibile modificare la proprietà trackAsMenu in qualsiasi momento; il clip filmato modificato utilizza immediatamente il nuovo comportamento.


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

Esempio

Il codice seguente mostra l'utilizzo della proprietà trackAsMenu per attivare gli eventi relativi al rilascio del mouse per un oggetto MovieClip di nome mc1:
 mc1.trackAsMenu = true;
Descrizione della funzione di costruzione
MovieClip()Funzione di costruzione
public function MovieClip()

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea una nuova istanza MovieClip. Dopo aver creato l'istanza MovieClip, chiamare il metodo addChild() o addChildAt() di un contenitore di oggetto di visualizzazione che si trova sullo stage.

Descrizione dei metodi
gotoAndPlay()metodo
public function gotoAndPlay(frame:Object, scene:String = null):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Avvia la riproduzione del file SWF dal fotogramma specificato. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma. Per specificare una scena oltre a un fotogramma, fornire un valore per il parametro scene.

Parametri

frame:Object — Un numero che rappresenta il numero del fotogramma, o una stringa che rappresenta l'etichetta del fotogramma a cui viene inviato l'indicatore di riproduzione. Se si specifica un numero, questo è relativo alla scena specificata. Se non viene specificata una scena, Flash Player utilizza la scena corrente per determinare il numero di fotogramma globale da riprodurre. Se invece si specifica una scena, l'indicatore di riproduzione viene inviato al numero di fotogramma di tale scena.
 
scene:String (default = null) — Il nome della scena da riprodurre. Questo parametro è opzionale.


Esempio

Nel codice seguente viene utilizzato il metodo gotoAndPlay() per spostare l'indicatore di riproduzione del clip filmato mc1 in avanti di cinque fotogrammi rispetto alla posizione corrente:
mc1.gotoAndPlay(mc1.currentFrame + 5);

Nel codice seguente viene utilizzato il metodo gotoAndPlay() per spostare l'indicatore di riproduzione del clip filmato mc1 al fotogramma etichettato come "intro" nella scena di nome "Scene 12":
mc1.gotoAndPlay("intro", "Scene 12");
gotoAndStop()metodo 
public function gotoAndStop(frame:Object, scene:String = null):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Posiziona l'indicatore di riproduzione sul fotogramma specificato del clip filmato. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma. Per specificare una scena oltre a un fotogramma, utilizzare il parametro scene.

Parametri

frame:Object — Un numero che rappresenta il numero del fotogramma, o una stringa che rappresenta l'etichetta del fotogramma a cui viene inviato l'indicatore di riproduzione. Se si specifica un numero, questo è relativo alla scena specificata. Se non viene specificata una scena, Flash Player utilizza la scena corrente per determinare il numero di fotogramma globale sul quale inviare e fermare l'indicatore di riproduzione. Se invece si specifica una scena, l'indicatore di riproduzione viene inviato e fermato sul numero di fotogramma della scena specificata.
 
scene:String (default = null) — Il nome della scena. Questo parametro è opzionale.


Genera
ArgumentError — Se la scena (scene) o il fotogramma (frame) specificati non vengono trovati nel clip filmato.

Esempio

Nel codice seguente vengono utilizzati il metodo gotoAndStop() e la proprietà currentFrame per indicare all'indicatore di riproduzione del clip filmato mc1 di avanzare di cinque fotogrammi rispetto alla posizione corrente e fermarsi:
mc1.gotoAndStop(mc1.currentFrame + 5);

Nel codice seguente viene utilizzato il metodo gotoAndStop() per spostare l'indicatore di riproduzione del clip filmato mc1 al fotogramma etichettato come "finale" nella scena di nome "Scene 12":
mc1.gotoAndStop("finale", "Scene 12");
nextFrame()metodo 
public function nextFrame():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Invia l'indicatore di riproduzione al fotogramma successivo e lo interrompe. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma.

Vedere anche


Esempio

Nell'esempio seguente, due oggetti SimpleButton controllano la linea temporale. Il pulsante prev sposta l'indicatore di riproduzione sul fotogramma precedente, mentre il pulsante nextBtn sposta l'indicatore di riproduzione sul fotogramma successivo.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevFrame();
}

function goForward(event:MouseEvent):void {
    mc1.nextFrame();
}
nextScene()metodo 
public function nextScene():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Sposta l'indicatore di riproduzione sulla scena successiva dell'istanza MovieClip. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma.


Esempio

Nell'esempio seguente, due oggetti SimpleButton controllano la linea temporale. Il pulsante prevBtn sposta l'indicatore di riproduzione sulla scena precedente, mentre il pulsante nextBtn sposta l'indicatore di riproduzione sulla scena successiva.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevScene();
}

function goForward(event:MouseEvent):void {
    mc1.nextScene();
}
play()metodo 
public function play():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Sposta l'indicatore di riproduzione nella linea temporale del clip filmato.

Vedere anche


Esempio

Il codice seguente utilizza il metodo stop() per interrompere un clip filmato di nome mc1 e per riprendere la riproduzione quando l'utente fa clic sul campo di testo di nome continueText:

import flash.text.TextField;
import flash.events.MouseEvent;

var continueText:TextField = new TextField();
continueText.text = "Play movie...";
addChild(continueText);

mc1.stop();
continueText.addEventListener(MouseEvent.CLICK, resumeMovie);

function resumeMovie(event:MouseEvent):void {
    mc1.play();
}
prevFrame()metodo 
public function prevFrame():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Invia l'indicatore di riproduzione al fotogramma precedente e lo interrompe. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma.


Esempio

Nell'esempio seguente, due oggetti SimpleButton controllano la linea temporale. Il pulsante prev sposta l'indicatore di riproduzione sul fotogramma precedente, mentre il pulsante nextBtn sposta l'indicatore di riproduzione sul fotogramma successivo.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevFrame();
}

function goForward(event:MouseEvent):void {
    mc1.nextFrame();
}
prevScene()metodo 
public function prevScene():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Sposta l'indicatore di riproduzione sulla scena precedente dell'istanza MovieClip. Questa azione viene eseguita dopo l'esecuzione di tutte le altre azioni del fotogramma.


Esempio

Nell'esempio seguente, due oggetti SimpleButton controllano la linea temporale. Il pulsante prevBtn sposta l'indicatore di riproduzione sulla scena precedente, mentre il pulsante nextBtn sposta l'indicatore di riproduzione sulla scena successiva.

import flash.events.MouseEvent;

mc1.stop();
prevBtn.addEventListener(MouseEvent.CLICK, goBack);
nextBtn.addEventListener(MouseEvent.CLICK, goForward);

function goBack(event:MouseEvent):void {
    mc1.prevScene();
}

function goForward(event:MouseEvent):void {
    mc1.nextScene();
}
stop()metodo 
public function stop():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Ferma l'indicatore di riproduzione nel clip filmato.

Esempi Come utilizzare gli esempi
MovieClipExample.as

L'esempio seguente utilizza la classe MovieClipExample per mostrare come monitorare varie proprietà di un MovieClip. Questa operazione viene eseguita mediante la procedura seguente:
  1. La funzione di costruzione definisce un campo di testo, che viene utilizzato per visualizzare i valori delle proprietà dell'oggetto MovieClipExample (che estende MovieClip).
  2. Il valore restituito dal metodo getPropertiesString() viene utilizzato come testo per il campo di testo outputText. Il metodo getPropertiesString() restituisce una stringa che viene compilata con i valori delle seguenti proprietà del clip filmato: currentFrame, currentLabel, currentScene, framesLoaded, totalFrames e trackAsMenu.
  3. Le proprietà width e height del campo di testo outputText sono regolate da due righe di codice nella funzione di costruzione.
  4. L'ultima riga della funzione di costruzione aggiunge il campo di testo outputText all'elenco di visualizzazione.

package {
    import flash.display.MovieClip;
    import flash.text.TextField;

    public class MovieClipExample extends MovieClip {

        public function MovieClipExample() {
            var outputText:TextField = new TextField();
            outputText.text = getPropertiesString();
            outputText.width = stage.stageWidth;
            outputText.height = outputText.textHeight;
            addChild(outputText);
        }

        private function getPropertiesString():String {
            var str:String = ""
                + "currentFrame: " + currentFrame + "\n"
                + "currentLabel: " + currentLabel + "\n"
                + "currentScene: " + currentScene + "\n"
                + "framesLoaded: " + framesLoaded + "\n"
                + "totalFrames: " + totalFrames + "\n"
                + "trackAsMenu: " + trackAsMenu + "\n";
            return str;
        }
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/display/MovieClip.html