Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: AIR 30.0 e versioni precedenti, Flash Player 30.0 e versioni precedenti, Flash Lite 4
Flex 4.6 e versioni precedenti, Flash Pro CS6 e versioni precedenti
Nascondi filtri
fl.transitions 

Tween  - AS3 Flash

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

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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 applicare metodi e proprietà della classe Tween, utilizzate l'operatore new con la funzione di costruzione per creare un'istanza della classe e specificate 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 gli esempi

Elementi API correlati



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
  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
  
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 di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 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[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.EventDispatcher
 Inherited[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato 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à

begin

proprietà
public var begin:Number = NaN

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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

duration

proprietà 
duration:Number

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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



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

finish

proprietà 
finish:Number

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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 create una nuova istanza Tween o quando chiamate il metodo Tween.yoyo().



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

Elementi API correlati

FPS

proprietà 
FPS:Number

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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

Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente viene illustrato come ignorare la frequenza di fotogrammi predefinita per un'interpolazione programmatica in Flash Professional, impostando la proprietà FPS dell'oggetto Tween. Esempio fornito da ActionScriptExamples.com.
import fl.transitions.Tween;
import fl.transitions.easing.*;
 
var tween:Tween = new Tween(mc, "x", Elastic.easeOut, 0, 300, 3, true);
tween.FPS = 60;
 
mc.addEventListener(MouseEvent.CLICK, onClick);
 
function onClick(evt:MouseEvent):void {
    tween.start();
}

func

proprietà 
public var func:Function

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

La funzione di andamento utilizzata con l'interpolazione.

isPlaying

proprietà 
public var isPlaying:Boolean = false

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Indica se l'interpolazione è in corso di riproduzione.

looping

proprietà 
public var looping:Boolean = false

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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.

obj

proprietà 
public var obj:Object = null

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

L'oggetto target in corso di interpolazione.

position

proprietà 
position:Number

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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

prop

proprietà 
public var prop:String

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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

time

proprietà 
time:Number

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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



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

useSeconds

proprietà 
public var useSeconds:Boolean = false

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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 prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Crea un'istanza della classe Tween. Utilizzate 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.

Elementi API correlati

Descrizione dei metodi

continueTo

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

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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.

Elementi API correlati

fforward

()metodo 
public function fforward():void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Passa l'animazione interpolata direttamente al valore finale.

nextFrame

()metodo 
public function nextFrame():void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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

Nota: utilizzate 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 prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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

Nota: utilizzate 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.

Elementi API correlati

resume

()metodo 
public function resume():void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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

Nota: utilizzate 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 prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

Riporta la riproduzione dell'animazione interpolata al punto iniziale. Se Tween.rewind() viene chiamato mentre 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. Utilizzate 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 prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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 prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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

yoyo

()metodo 
public function yoyo():void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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. Potete 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
proprietà TweenEvent.type = fl.transitions.TweenEvent.MOTION_CHANGE

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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 utilizzate 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 intercetta l'evento. Utilizzate la proprietà currentTarget per accedere sempre all'oggetto che intercetta 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
proprietà TweenEvent.type = fl.transitions.TweenEvent.MOTION_FINISH

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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 utilizzate 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 intercetta l'evento. Utilizzate la proprietà currentTarget per accedere sempre all'oggetto che intercetta 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
proprietà TweenEvent.type = fl.transitions.TweenEvent.MOTION_LOOP

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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 utilizzate 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 intercetta l'evento. Utilizzate la proprietà currentTarget per accedere sempre all'oggetto che intercetta 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
proprietà TweenEvent.type = fl.transitions.TweenEvent.MOTION_RESUME

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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 utilizzate 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 intercetta l'evento. Utilizzate la proprietà currentTarget per accedere sempre all'oggetto che intercetta 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
proprietà TweenEvent.type = fl.transitions.TweenEvent.MOTION_START

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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 utilizzate 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 intercetta l'evento. Utilizzate la proprietà currentTarget per accedere sempre all'oggetto che intercetta 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
proprietà TweenEvent.type = fl.transitions.TweenEvent.MOTION_STOP

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flash CS3
Versioni runtime: Flash Player 9, AIR 1.0

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 utilizzate 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 intercetta l'evento. Utilizzate la proprietà currentTarget per accedere sempre all'oggetto che intercetta 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.
Tween_class.as

In questo esempio viene animato un rettangolo utilizzando il valore fornito tramite l'immissione di un numero in un campo di testo. Il campo di testo imposta la proprietà width del quadrato interpolato in modo che corrisponda al valore specificato. Il valore viene memorizzato nella variabile userNumber, che viene quindi passata alla funzione di costruzione Tween come parametro per la larghezza della forma.

Nota: per le classi nel pacchetto fl.transitions, dovete utilizzare un'istruzione import nel pannello Azioni di Flash Professional (per la maggior parte delle classi è necessario utilizzare l'istruzione import nel pannello Azioni). Utilizzate * a livello di pacchetto per includere tutte le classi nel pacchetto oppure potete importarle singolarmente.

import fl.transitions.Tween;
import fl.transitions.easing.*;
   
//create a Sprite instance
var mySprite:Sprite = new Sprite()
   
// create an input text field
var myTextField:TextField = new TextField();
   
myTextField.type = TextFieldType.INPUT;
myTextField.width = 180;
myTextField.height = 20;
myTextField.x = 20;
myTextField.y = 140;
myTextField.border = true;
myTextField.text = "Type a number here and press Enter";
myTextField.restrict = "0-9";   
 
addChild(myTextField);

// add a listener when the user clicks in the text field
myTextField.addEventListener(MouseEvent.CLICK, fieldClickHandler);

// add a listener for a key press
myTextField.addEventListener(KeyboardEvent.KEY_DOWN, keyDownHandler);
 
// clear the text field when the user clicks in it to enter a value
function fieldClickHandler(event:MouseEvent):void {
    myTextField.text = "";
}

// if the key pressed is the Enter key
// change the values of the box's width based on the value provided
function keyDownHandler(event:KeyboardEvent):void {
     if (event.keyCode == Keyboard.ENTER) {  

     mySprite.graphics.clear();
     var userNumber:Number = new Number(myTextField.text);
     mySprite.graphics.beginFill(0x666999);
     mySprite.graphics.drawRect(0, 0, 40, 120);
     addChild(mySprite);
     //provide tween values, including passing the variable userNumber for the width at
     //the end of the tween
     var myTween:Tween = new Tween(mySprite, "width", Elastic.easeOut, 0, userNumber, 4, true);
     }
} 

Tween_class2.as

Questo esempio è sostanzialmente uguale al precedente, ma utilizza l'API di disegno avanzata per creare la forma disegnata.
import fl.transitions.Tween;
import fl.transitions.easing.*;

//create a Sprite instance
var mySprite:Sprite = new Sprite()

// create an input text field
var myTextField:TextField = new TextField();
 
myTextField.type = TextFieldType.INPUT;
myTextField.width = 180;
myTextField.height = 20;
myTextField.x = 20;
myTextField.y = 140;
myTextField.border = true;
myTextField.text = "Type a number here and press Enter";
myTextField.restrict = "0-9";   
 
addChild(myTextField);

// add a listener when the user clicks in the text field
myTextField.addEventListener(MouseEvent.CLICK, fieldClickHandler);


// add a listener for a key press
myTextField.addEventListener(KeyboardEvent.KEY_DOWN, keyDownHandler);
 
// clear the text field when the user clicks in it to enter a value
function fieldClickHandler(event:MouseEvent):void {
    myTextField.text = "";
}

// if the key pressed is the Enter key
// change the values of the box's width based on the value provided
function keyDownHandler(event:KeyboardEvent):void {
     if (event.keyCode == Keyboard.ENTER) { 

     mySprite.graphics.clear();
    var userNumber:Number = new Number(myTextField.text);

    // Set up drawing data
    // stroke object
    var myStroke:GraphicsStroke = new GraphicsStroke(2);
    myStroke.joints = JointStyle.MITER;
    myStroke.fill = new GraphicsSolidFill(0x102020); // solid stroke
           
    // fill object
    var myFill:GraphicsGradientFill = new GraphicsGradientFill();
    myFill.colors = [0xEEFFEE, 0x0000FF];
    myFill.matrix = new Matrix();
    myFill.matrix.createGradientBox(300, 300, 0);
           
    // path object
    var myPath:GraphicsPath = new GraphicsPath(new Vector.<int>(), new Vector.<Number>());
    myPath.commands.push(1,2,2,2,2);
    myPath.data.push(0,0, 240,0, 240,60, 0,60, 0,0);

    // combine the objects for a complete drawing
    var myDrawing:Vector.<IGraphicsData> = new Vector.<IGraphicsData>();
    myDrawing.push(myStroke, myFill, myPath);
           
    // render the drawing 
    mySprite.graphics.drawGraphicsData(myDrawing);
    addChild(mySprite);

    //provide tween values, including passing the variable userNumber for the width at
    //the end of the tween
     var myTween:Tween = new Tween(mySprite, "width", Elastic.easeOut, 0, userNumber, 4, true);
      }

}




[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.