Pacchettofl.transitions
Classepublic class Tween
EreditarietàTween Inheritance EventDispatcher Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La classe Tween consente di spostare, ridimensionare e applicare dissolvenze ai clip filmato mediante ActionScript, specificando una proprietà del clip filmato target da animare per un numero stabilito di fotogrammi o secondi.

Può essere utilizzata anche per specificare diversi metodi di andamento. L'andamento si riferisce all'accelerazione o decelerazione graduale dell'animazione, che consentono di rendere più realistica l'animazione. Nel pacchetto fl.transitions.easing sono disponibili numerosi metodi di andamento che contengono equazioni per l'effetto di accelerazione e decelerazione, che modificano di conseguenza l'animazione dell'andamento.

Per utilizzare metodi e proprietà della classe Tween, è necessario usare l'operatore new con la funzione di costruzione per creare un'istanza della classe e specificare un metodo di andamento come parametro. Ad esempio:

 import fl.transitions.Tween;
 import fl.transitions.easing.*;
 var myTween:Tween = new Tween(myObject, "x", Elastic.easeOut, 0, 300, 3, true);
 

Vedere anche

fl.transitions.TransitionManager
fl.transitions.easing
Tween()


Proprietà pubbliche
 ProprietàDefinito da
  begin: Number = NaN
Il valore iniziale della proprietà specificata dell'oggetto target prima dell'avvio dell'interpolazione.
Tween
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  duration: Number
La durata dell'animazione con interpolazione di movimento, espressa in fotogrammi o secondi.
Tween
  finish: Number
Un numero che indica il valore finale della proprietà dell'oggetto target cui applicare l'interpolazione di movimento.
Tween
  FPS: Number
Il numero di fotogrammi al secondo calcolati nell'animazione interpolata.
Tween
  func: Function
La funzione di andamento utilizzata con l'interpolazione.
Tween
  isPlaying: Boolean = false
Indica se l'interpolazione è in corso di riproduzione.
Tween
  looping: Boolean = false
Indica se l'interpolazione viene ripetuta ciclicamente.
Tween
  obj: Object = null
L'oggetto target in corso di interpolazione.
Tween
  position: Number
Il valore corrente della proprietà dell'oggetto target a cui si sta applicando l'interpolazione di movimento.
Tween
  prop: String = ""
Il nome della proprietà interessata dall'interpolazione dell'oggetto target.
Tween
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  time: Number
Il tempo corrente all'interno della durata dell'animazione.
Tween
  useSeconds: Boolean = false
Indica se l'interpolazione viene riprodotta per un intervallo di fotogrammi o di secondi.
Tween
Metodi pubblici
 MetodoDefinito da
  
Tween(obj:Object, prop:String, func:Function, begin:Number, finish:Number, duration:Number, useSeconds:Boolean = false)
Crea un'istanza della classe Tween.
Tween
 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
  
continueTo(finish:Number, duration:Number):void
Indica all'animazione con interpolazione di movimento di continuare l'interpolazione dal punto corrente a un nuovo punto finish e duration.
Tween
 Inherited
Invia un evento nel flusso di eventi.
EventDispatcher
  
Passa l'animazione interpolata direttamente al valore finale.
Tween
 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
  
Invia l'animazione interpolata al fotogramma successivo di un'animazione che è stata interrotta.
Tween
  
Riproduce il fotogramma precedente dell'animazione interpolata dal punto in cui era stata interrotta.
Tween
 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 la riproduzione di un'animazione interpolata che è stata precedentemente interrotta.
Tween
  
rewind(t:Number = 0):void
Riporta la riproduzione dell'animazione interpolata al punto iniziale.
Tween
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
Avvia la riproduzione dell'animazione interpolata dal punto iniziale.
Tween
  
Interrompe la riproduzione dell'animazione interpolata in corrispondenza del valore corrente.
Tween
 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
  
Indica la riproduzione dell'animazione interpolata nella direzione inversa rispetto a quella degli ultimi incrementi della proprietà interpolata.
Tween
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 l'evento Tween è cambiato e lo schermo è stato aggiornato.Tween
   Indica che l'evento Tween ha raggiunto la fine ed è terminato.Tween
   Indica che la riproduzione di Tween è stata riavviata dall'inizio in modalità ciclica.Tween
   Indica che la riproduzione dell'evento Tween è stata ripresa dopo essere stata messa in pausa.Tween
   Indica che è iniziata la riproduzione del movimento.Tween
   Indica che l'evento Tween è stato interrotto con una chiamata esplicita a Tween.stop().Tween
Descrizione delle proprietà
beginproprietà
public var begin:Number = NaN

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il valore iniziale della proprietà specificata dell'oggetto target prima dell'avvio dell'interpolazione.

durationproprietà 
duration:Number  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La durata dell'animazione con interpolazione di movimento, espressa in fotogrammi o secondi. Questa proprietà viene impostata come parametro quando si crea una nuova istanza Tween o quando si chiama il metodo Tween.yoyo().


Implementazione
    public function get duration():Number
    public function set duration(value:Number):void
finishproprietà 
finish:Number  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un numero che indica il valore finale della proprietà dell'oggetto target cui applicare l'interpolazione di movimento. Questa proprietà viene impostata come parametro quando si crea una nuova istanza Tween o quando si chiama il metodo Tween.yoyo().


Implementazione
    public function get finish():Number
    public function set finish(value:Number):void

Vedere anche

FPSproprietà 
FPS:Number  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il numero di fotogrammi al secondo calcolati nell'animazione interpolata. Per impostazione predefinita la frequenza dei fotogrammi dello stage corrente viene utilizzata per calcolare l'animazione interpolata. L'impostazione di questa proprietà consente di ricalcolare il numero di incrementi nella proprietà animata che viene visualizzata ogni secondo nella proprietà Tween.FPS anziché nella frequenza dei fotogrammi dello stage corrente. L'impostazione della proprietà Tween.FPS non modifica la frequenza dei fotogrammi effettiva dello stage.

Nota:la proprietà Tween.FPS restituisce un valore undefined a meno che non venga impostata esplicitamente.


Implementazione
    public function get FPS():Number
    public function set FPS(value:Number):void
funcproprietà 
public var func:Function

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La funzione di andamento utilizzata con l'interpolazione.

isPlayingproprietà 
public var isPlaying:Boolean = false

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se l'interpolazione è in corso di riproduzione.

loopingproprietà 
public var looping:Boolean = false

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se l'interpolazione viene ripetuta ciclicamente. Se il valore è true, l'interpolazione viene riavviata indefinitamente ogni volta che viene completata. Se il valore è false, l'interpolazione viene riprodotta una sola volta.

objproprietà 
public var obj:Object = null

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

L'oggetto target in corso di interpolazione.

positionproprietà 
position:Number  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il valore corrente della proprietà dell'oggetto target a cui si sta applicando l'interpolazione di movimento. Questo valore viene aggiornato con ogni fotogramma disegnato dell'animazione interpolata.


Implementazione
    public function get position():Number
    public function set position(value:Number):void
propproprietà 
public var prop:String = ""

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il nome della proprietà interessata dall'interpolazione dell'oggetto target.

timeproprietà 
time:Number  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il tempo corrente all'interno della durata dell'animazione.


Implementazione
    public function get time():Number
    public function set time(value:Number):void
useSecondsproprietà 
public var useSeconds:Boolean = false

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se l'interpolazione viene riprodotta per un intervallo di fotogrammi o di secondi. Se il valore è true, l'interpolazione viene animata per il numero di secondi specificato dalla proprietà duration. Se il valore è false, l'interpolazione viene animata per un numero di fotogrammi.

Descrizione della funzione di costruzione
Tween()Funzione di costruzione
public function Tween(obj:Object, prop:String, func:Function, begin:Number, finish:Number, duration:Number, useSeconds:Boolean = false)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea un'istanza della classe Tween. Utilizzare la funzione di costruzione con l'operatore new: var myTween:Tween = new Tween().

Parametri
obj:Object — Oggetto cui fa riferimento Tween.
 
prop:String — Nome della proprietà (valore di parametro obj) che verrà influenzata.
 
func:Function — Nome della funzione di andamento da usare.
 
begin:Number — Valore iniziale del parametro prop.
 
finish:Number — Un numero che indica il valore finale del parametro prop (la proprietà dell'oggetto target cui applicare l'interpolazione di movimento).
 
duration:Number — La durata del movimento in termini di tempo; impostato su infinity se il numero è negativo o se non viene specificato
 
useSeconds:Boolean (default = false) — Indicatore che specifica se usare i secondi invece dei fotogrammi La funzione impiega i secondi se impostata su true, oppure i fotogrammi in relazione al valore specificato nel parametro duration se impostata su false.

Vedere anche

Descrizione dei metodi
continueTo()metodo
public function continueTo(finish:Number, duration:Number):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica all'animazione con interpolazione di movimento di continuare l'interpolazione dal punto corrente a un nuovo punto finish e duration.

Parametri

finish:Number — Un numero che indica il valore finale della proprietà dell'oggetto target cui applicare l'interpolazione di movimento.
 
duration:Number — Un numero che indica la lunghezza temporale o il numero di fotogrammi per il movimento di interpolazione. La durata viene misurata in lunghezza temporale se il parametro Tween.start() useSeconds è impostato su true oppure in fotogrammi se è impostato su false.

Vedere anche

fforward()metodo 
public function fforward():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Passa l'animazione interpolata direttamente al valore finale.

nextFrame()metodo 
public function nextFrame():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Invia l'animazione interpolata al fotogramma successivo di un'animazione che è stata interrotta. Utilizzare questo metodo per far avanzare di un fotogramma alla volta un'animazione interpolata dopo averla interrotta attraverso il metodo Tween.stop().

Nota: utilizzare questo metodo solo su interpolazioni basate sui fotogrammi. Un'interpolazione di movimento viene impostata in base al fotogramma al momento della creazione impostando il parametro useSeconds su false.

prevFrame()metodo 
public function prevFrame():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Riproduce il fotogramma precedente dell'animazione interpolata dal punto in cui era stata interrotta. Utilizzare questo metodo per riprodurre all'indietro di un fotogramma alla volta un'animazione interpolata dopo averla interrotta attraverso il metodo Tween.stop().

Nota: utilizzare questo metodo solo su interpolazioni basate sui fotogrammi. Un'interpolazione di movimento viene impostata in base al fotogramma al momento della creazione impostando il parametro Tween.start() useSeconds su false.

Vedere anche

resume()metodo 
public function resume():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Riprende la riproduzione di un'animazione interpolata che è stata precedentemente interrotta. Utilizzare questo metodo per riprendere un'animazione interpolata dopo averla interrotta attraverso il metodo Tween.stop().

Nota: utilizzare questo metodo solo su interpolazioni basate sui fotogrammi. Un'interpolazione di movimento viene impostata in base al fotogramma al momento della creazione impostando il parametro useSeconds su false.

rewind()metodo 
public function rewind(t:Number = 0):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Riporta la riproduzione dell'animazione interpolata al punto iniziale. SeTween.rewind() viene chiamato mente l'animazione interpolata è ancora in riproduzione, l'animazione viene riportata al valore iniziale e la riproduzione prosegue. Se Tween.rewind() viene chiamato durante l'interruzione o il completamento dell'animazione, l'animazione interpolata viene riportata al valore iniziale e non riprende. Utilizzare questo metodo per riavvolgere un'animazione interpolata fino al punto iniziale dopo averla interrotta attraverso il metodo Tween.stop() o per riavvolgerla durante la riproduzione.

Parametri

t:Number (default = 0) — Valore iniziale.

start()metodo 
public function start():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Avvia la riproduzione dell'animazione interpolata dal punto iniziale. Questo metodo viene utilizzato per riavviare un oggetto Tween dall'inizio dell'animazione dopo che quest'ultima è stata interrotta o completata.

stop()metodo 
public function stop():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Interrompe la riproduzione dell'animazione interpolata in corrispondenza del valore corrente.

yoyo()metodo 
public function yoyo():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica la riproduzione dell'animazione interpolata nella direzione inversa rispetto a quella degli ultimi incrementi della proprietà interpolata. Se questo metodo viene chiamato prima del completamento dell'animazione di un oggetto Tween, l'animazione passa bruscamente alla fine della riproduzione e viene riprodotta nella direzione inversa a partire da quel punto. È possibile ottenere un effetto di animazione portando a termine la riproduzione completa e invertendola completamente mediante la chiamata del metodo Tween.yoyo() all'interno di un gestore di eventi TweenEvent.MOTION_FINISH. Questa operazione garantisce che l'effetto di inversione del metodo Tween.yoyo non inizi se non dopo il completamento dell'animazione interpolata corrente.

Descrizione degli eventi
motionChange Evento
Tipo di oggetto evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_CHANGE

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Inviato quando l'evento Tween è cambiato 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 della proprietà 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.
timeIl valore temporale di Tween nel momento in cui l'evento si è verificato.
positionIl valore della proprietà controllata da Tween, nel momento in cui l'evento si è verificato.
motionFinish Evento  
Tipo di oggetto evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_FINISH

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica che l'evento Tween ha raggiunto la fine ed è terminato.

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 della proprietà 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.
timeIl valore temporale di Tween nel momento in cui l'evento si è verificato.
positionIl valore della proprietà controllata da Tween, nel momento in cui l'evento si è verificato.
motionLoop Evento  
Tipo di oggetto evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_LOOP

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica che la riproduzione di Tween è stata riavviata dall'inizio in modalità ciclica.

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 della proprietà 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.
timeIl valore temporale di Tween nel momento in cui l'evento si è verificato.
positionIl valore della proprietà controllata da Tween, nel momento in cui l'evento si è verificato.
motionResume Evento  
Tipo di oggetto evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_RESUME

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica che la riproduzione dell'evento Tween è stata ripresa dopo essere stata messa in pausa.

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 della proprietà 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.
timeIl valore temporale di Tween nel momento in cui l'evento si è verificato.
positionIl valore della proprietà controllata da Tween, nel momento in cui l'evento si è verificato.
motionStart Evento  
Tipo di oggetto evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_START

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica che è iniziata la riproduzione del movimento.

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 della proprietà 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.
timeIl valore temporale di Tween nel momento in cui l'evento si è verificato.
positionIl valore della proprietà controllata da Tween, nel momento in cui l'evento si è verificato.
motionStop Evento  
Tipo di oggetto evento: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_STOP

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica che l'evento Tween è stato interrotto con una chiamata esplicita a Tween.stop().

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 della proprietà 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.
timeIl valore temporale di Tween nel momento in cui l'evento si è verificato.
positionIl valore della proprietà controllata da Tween, nel momento in cui l'evento si è verificato.




 

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/transitions/Tween.html