Pacchettofl.motion
Classepublic class Animator
EreditarietàAnimator Inheritance EventDispatcher Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

La classe Animator applica una descrizione XML di un'interpolazione di movimento a un oggetto di visualizzazione. Le proprietà e i metodi della classe Animator controllano la riproduzione del movimento e Flash Player trasmette degli eventi in risposta alle modifiche allo stato del movimento. La classe Animator viene utilizzata principalmente dal comando "Copia movimento come ActionScript" in Flash CS3. È possibile modificare il codice ActionScript mediante l'API oppure creare un'animazione personalizzata.

Se si intende chiamare i metodi della classe Animator all'interno di una funzione, è necessario dichiarare l'istanza Animator al di fuori della funzione, affinché l'area di validità dell'oggetto non sia limitata alla funzione stessa. Se si dichiara l'istanza all'interno di una funzione, Flash Player eliminerà l'istanza Animator al termine della funzione durante la procedura di "garbage collection" di routine e l'oggetto target non verrà animato.

Nota: se non si utilizza Flash CS3 per compilare il file SWF, sono necessarie le classi fl.motion nel percorso di classe in fase di compilazione per applicare il movimento all'oggetto di visualizzazione.

Proprietà MXML predefinitamotion

Vedere anche

Elementi XML di Motion


Proprietà pubbliche
 ProprietàDefinito da
  autoRewind: Boolean = false
Imposta l'animazione in modo che riprenda da capo dopo che è terminata.
Animator
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  isPlaying: Boolean
[sola lettura] Indica se l'animazione è in corso di riproduzione.
Animator
  motion: Motion
L'oggetto che contiene le proprietà dell'interpolazione di movimento dell'animazione.
Animator
  orientToPath: Boolean = false
Imposta la posizione dell'oggetto di visualizzazione lungo il tracciato del movimento.
Animator
  positionMatrix: Matrix
L'oggetto Matrix che applica una trasformazione globale al tracciato di movimento.
Animator
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  repeatCount: int = 1
Numero di ripetizioni dell'animazione.
Animator
  target: DisplayObject
L'oggetto di visualizzazione in corso di animazione.
Animator
  time: int
Un numero intero a base zero che indica e controlla la posizione temporale dell'animazione corrente.
Animator
  transformationPoint: Point
Il punto di riferimento per la rotazione o la modifica in scala di un oggetto di visualizzazione.
Animator
Metodi pubblici
 MetodoDefinito da
  
Animator(xml:XML = null, target:DisplayObject = null)
Crea un oggetto Animator per applicare la descrizione XML di un'interpolazione di movimento a un oggetto di visualizzazione.
Animator
 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
Invia un evento nel flusso di eventi.
EventDispatcher
  
end():void
Interrompe l'animazione e Flash Player passa immediatamente all'ultimo fotogramma nella sequenza di animazione.
Animator
  
fromXMLString(xmlString:String, target:DisplayObject = null):Animator
[statico] Crea un oggetto Animator da una stringa XML.
Animator
 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
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
  
Fa avanzare Flash Player al fotogramma successivo nella sequenza di animazione.
Animator
  
Mette in pausa l'animazione fino a quando viene chiamato il metodo resume().
Animator
  
Inizia l'animazione.
Animator
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Rimuove un listener dall'oggetto EventDispatcher.
EventDispatcher
  
Riprende l'animazione dopo che è stata messa in pausa dal metodo pause().
Animator
  
Imposta Flash Player sul primo fotogramma dell'animazione.
Animator
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
Interrompe l'animazione e Flash Player torna al primo fotogramma nella sequenza di animazione.
Animator
 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 Flash Player perde lo stato di attivazione del sistema operativo e sta per diventare inattivo.EventDispatcher
   Inviato quando termina la riproduzione del movimento, ovvero quando viene raggiunta la fine oppure quando la riproduzione viene interrotta da una chiamata al metodo stop() o end().Animator
   Inviato all'inizio della riproduzione del movimento.Animator
   Inviato quando il movimento è stato modificato e lo schermo è stato aggiornato.Animator
   Inviato quando il valore temporale dell'oggetto Animator è cambiato ma lo schermo non è ancora stato aggiornato (ovvero, l'evento motionUpdate).Animator
Descrizione delle proprietà
autoRewindproprietà
public var autoRewind:Boolean = false

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Imposta l'animazione in modo che riprenda da capo dopo che è terminata.

isPlayingproprietà 
isPlaying:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Indica se l'animazione è in corso di riproduzione.


Implementazione
    public function get isPlaying():Boolean
motionproprietà 
motion:Motion  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

L'oggetto che contiene le proprietà dell'interpolazione di movimento dell'animazione.


Implementazione
    public function get motion():Motion
    public function set motion(value:Motion):void
orientToPathproprietà 
public var orientToPath:Boolean = false

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Imposta la posizione dell'oggetto di visualizzazione lungo il tracciato del movimento. Se è true, la linea di base dell'oggetto di visualizzazione si orienta verso il tracciato del movimento; in caso contrario, è il punto di registrazione a orientarsi verso il tracciato del movimento.

positionMatrixproprietà 
public var positionMatrix:Matrix

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

L'oggetto Matrix che applica una trasformazione globale al tracciato di movimento. Questa matrice consente di spostare, modificare in scala, inclinare e ruotare il tracciato senza modificare l'aspetto dell'oggetto di visualizzazione.

repeatCountproprietà 
public var repeatCount:int = 1

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Numero di ripetizioni dell'animazione. I valori possibili sono tutti i numeri interi superiori o uguali a 0. Un valore pari a 1 indica che l'animazione viene riprodotta una sola volta. Il valore 0 indica che l'animazione viene riprodotta indefinitamente fino a quando viene esplicitamente interrotta (ad esempio, mediante una chiamata al metodo end()).

Il valore predefinito è 1.

Vedere anche

targetproprietà 
target:DisplayObject  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

L'oggetto di visualizzazione in corso di animazione. È possibile utilizzare qualunque sottoclasse di flash.display.DisplayObject, ad esempio MovieClip, Sprite o Bitmap.


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

Vedere anche

timeproprietà 
time:int  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Un numero intero a base zero che indica e controlla la posizione temporale dell'animazione corrente. In corrispondenza del primo fotogramma dell'animazione il valore di time è 0. Se l'animazione ha una durata di 10 fotogrammi, il valore di time nell'ultimo fotogramma è 9.


Implementazione
    public function get time():int
    public function set time(value:int):void
transformationPointproprietà 
public var transformationPoint:Point

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Il punto di riferimento per la rotazione o la modifica in scala di un oggetto di visualizzazione. Il punto di trasformazione è relativo al riquadro di delimitazione dell'oggetto di visualizzazione. Le coordinate del punto devono essere modificate in scala fino a ottenere una casella di 1 x 1 pixel, dove (1, 1) è l'angolo inferiore destro dell'oggetto e (0, 0) è l'angolo superiore sinistro.

Descrizione della funzione di costruzione
Animator()Funzione di costruzione
public function Animator(xml:XML = null, target:DisplayObject = null)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Crea un oggetto Animator per applicare la descrizione XML di un'interpolazione di movimento a un oggetto di visualizzazione.

Parametri
xml:XML (default = null) — Un oggetto E4X che contiene la descrizione dell'interpolazione di movimento basata su XML.
 
target:DisplayObject (default = null) — L'oggetto di visualizzazione che utilizza l'interpolazione di movimento.

Vedere anche

Descrizione dei metodi
end()metodo
public function end():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Interrompe l'animazione e Flash Player passa immediatamente all'ultimo fotogramma nella sequenza di animazione. Se la proprietà autoRewind è impostata su true, Flash Player passa al primo fotogramma nella sequenza di animazione.

Vedere anche

fromXMLString()metodo 
public static function fromXMLString(xmlString:String, target:DisplayObject = null):Animator

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Crea un oggetto Animator da una stringa XML. Questo metodo è un'alternativa all'utilizzo della funzione di costruzione Animator, che accetta invece un oggetto E4X.

Parametri

xmlString:String — Una stringa XML che specifica il tipo di interpolazione di movimento.
 
target:DisplayObject (default = null) — L'oggetto di visualizzazione che utilizza l'interpolazione di movimento.

Restituisce
Animator — Un'istanza Animator che applica l'oggetto xmlString specificato all'oggetto target specificato.

Vedere anche

nextFrame()metodo 
public function nextFrame():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Fa avanzare Flash Player al fotogramma successivo nella sequenza di animazione.

pause()metodo 
public function pause():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Mette in pausa l'animazione fino a quando viene chiamato il metodo resume().

Vedere anche

play()metodo 
public function play():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Inizia l'animazione. Chiamare il metodo end() prima di play() per assicurarsi che tutte le eventuali istanze precedenti dell'animazione siano terminate prima di iniziarne una nuova.

Vedere anche

resume()metodo 
public function resume():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Riprende l'animazione dopo che è stata messa in pausa dal metodo pause().

Vedere anche

rewind()metodo 
public function rewind():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Imposta Flash Player sul primo fotogramma dell'animazione. Se l'animazione è in corso di riproduzione, la riproduzione continua dal primo fotogramma. Se l'animazione è stata interrotta, la riproduzione rimane ferma al primo fotogramma.

stop()metodo 
public function stop():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Interrompe l'animazione e Flash Player torna al primo fotogramma nella sequenza di animazione.

Vedere anche

Descrizione degli eventi
motionEnd Evento
Tipo di oggetto evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_END

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Inviato quando termina la riproduzione del movimento, ovvero quando viene raggiunta la fine oppure quando la riproduzione viene interrotta da una chiamata al metodo stop() o end().

Indica che il movimento è stato interrotto mediante una chiamata esplicita a Animator.stop() o Animator.end() oppure perché è stata raggiunta la fine dell'istanza Motion.

Le proprietà degli oggetti evento hanno i seguenti valori:

ProprietàValore
bubblesfalse
cancelablefalse
currentTargetL'oggetto che definisce il listener di eventi che gestisce l'evento. Ad esempio, se si utilizza myButton.addEventListener() per registrare un listener di eventi, myButton è il valore di currentTarget.
targetL'oggetto che ha inviato l'evento; non si tratta sempre dell'oggetto che ascolta l'evento. Utilizzare la proprietà currentTarget per accedere sempre all'oggetto che ascolta l'evento.
motionStart Evento  
Tipo di oggetto evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_START

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Inviato all'inizio della riproduzione del movimento.

Indica che è iniziata la riproduzione dell'istanza Motion.

Le proprietà degli oggetti evento hanno i seguenti valori:

ProprietàValore
bubblesfalse
cancelablefalse
currentTargetL'oggetto che definisce il listener di eventi che gestisce l'evento. Ad esempio, se si utilizza myButton.addEventListener() per registrare un listener di eventi, myButton è il valore di currentTarget.
targetL'oggetto che ha inviato l'evento; non si tratta sempre dell'oggetto che ascolta l'evento. Utilizzare la proprietà currentTarget per accedere sempre all'oggetto che ascolta l'evento.
motionUpdate Evento  
Tipo di oggetto evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_UPDATE

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Inviato quando il movimento è stato modificato e lo schermo è stato aggiornato.

Inviato quando l'istanza Motion è cambiata e lo schermo è stato aggiornato.

Le proprietà degli oggetti evento hanno i seguenti valori:

ProprietàValore
bubblesfalse
cancelablefalse
currentTargetL'oggetto che definisce il listener di eventi che gestisce l'evento. Ad esempio, se si utilizza myButton.addEventListener() per registrare un listener di eventi, myButton è il valore di currentTarget.
targetL'oggetto che ha inviato l'evento; non si tratta sempre dell'oggetto che ascolta l'evento. Utilizzare la proprietà currentTarget per accedere sempre all'oggetto che ascolta l'evento.
timeChange Evento  
Tipo di oggetto evento: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.TIME_CHANGE

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9.0.28.0

Inviato quando il valore time dell'oggetto Animator è cambiato ma lo schermo non è ancora stato aggiornato (ovvero, l'evento motionUpdate).

Indica che il valore time dell'istanza Animator è cambiato ma lo schermo non è ancora stato aggiornato (ovvero, Flash Player non ha inviato l'evento motionUpdate).

Le proprietà degli oggetti evento hanno i seguenti valori:

ProprietàValore
bubblesfalse
cancelablefalse
currentTargetL'oggetto che definisce il listener di eventi che gestisce l'evento. Ad esempio, se si utilizza myButton.addEventListener() per registrare un listener di eventi, myButton è il valore di currentTarget.
targetL'oggetto che ha inviato l'evento; non si tratta sempre dell'oggetto che ascolta l'evento. Utilizzare la proprietà currentTarget per accedere sempre all'oggetto che ascolta l'evento.




 

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/fl/motion/Animator.html