Specifica il menu di scelta rapida associato all'oggetto.

Specifica se l'oggetto riceve gli eventi doubleClick. Il valore predefinito è false e indica che, per impostazione predefinita, un'istanza InteractiveObject non riceve gli eventi doubleClick. Se la proprietà doubleClickEnabled è impostata su true, l'istanza riceve gli eventi doubleClick nei propri limiti. Anche la proprietà mouseEnabled dell'istanza InteractiveObject deve essere impostata su true affinché l'oggetto possa ricevere gli eventi doubleClick.

Nessun evento viene inviato impostando questa proprietà. È necessario utilizzare il metodo addEventListener() per aggiungere un listener di eventi per l'evento doubleClick.

Vedere anche

Specifica se l'oggetto visualizza un rettangolo di attivazione. Il valore null indica che questo oggetto obbedisce alla proprietà stageFocusRect impostata sullo stage.

Specifica se l'oggetto riceve i messaggi relativi al mouse. Il valore predefinito è true e indica che, per impostazione predefinita, qualunque istanza InteractiveObject inclusa nell'elenco di visualizzazione riceve gli eventi del mouse. Se mouseEnabled è impostato su false, l'istanza non riceve gli eventi del mouse. L'impostazione non influisce sugli eventuali elementi secondari dell'istanza presenti nell'elenco di visualizzazione. Per cambiare il comportamento mouseEnabled di tutti gli elementi secondari di un oggetto dell'elenco di visualizzazione, utilizzare flash.display.DisplayObjectContainer.mouseChildren.

Nessun evento viene inviato impostando questa proprietà. È necessario utilizzare il metodo addEventListener() per creare la funzionalità interattiva.

Vedere anche

Specifica se questo oggetto è incluso nell'ordine di tabulazione. Se questo oggetto è nell'ordine di tabulazione, il valore è true, in caso contrario è false. Per impostazione predefinita, il valore è false, a eccezione dei casi seguenti:

• Per un oggetto SimpleButton, il valore è true.
• Per un oggetto TextField con type = "input", il valore è true.
• Per un oggetto Sprite o un oggetto MovieClip con buttonMode = true, il valore è true.

Specifica l'ordine di tabulazione degli oggetti in un file SWF. Il valore predefinito di questa proprietà tabIndex è -1 e indica che per l'oggetto non è impostato un indice di tabulazione.

Se un qualunque oggetto visualizzato nel file SWF contiene una proprietà tabIndex, l'ordine di tabulazione automatico viene disabilitato e viene calcolato in base alle proprietà tabIndex degli oggetti presenti nel file SWF. L'ordine di tabulazione personalizzato include solo gli oggetti dotati delle proprietà tabIndex.

La proprietà tabIndex può essere un numero intero non negativo. Gli oggetti vengono ordinati in base alle relative proprietà tabIndex, in ordine ascendente. Un oggetto con un valore tabIndex di 1 precede un oggetto con il valore tabIndex di 2. È sconsigliabile utilizzare lo stesso valore di tabIndex per più oggetti.

L'ordine di tabulazione personalizzato definito dalla proprietà tabIndex è di tipo flat. In altre parole, non viene prestata alcuna attenzione alle relazioni gerarchiche degli oggetti nel file SWF. Tutti gli oggetti del file SWF dotati delle proprietà tabIndex vengono inseriti nell'ordine di tabulazione, il quale viene determinato dall'ordine dei valori tabIndex.

Una chiamata alla funzione di costruzione new InteractiveObject() genera un'eccezione ArgumentError. È tuttavia possibile chiamare funzioni di costruzione per le seguenti sottoclassi di InteractiveObject:

• new SimpleButton()
• new TextField()
• new Loader()
• new Sprite()
• new MovieClip()

Inviato quando l'utente preme e rilascia il pulsante principale del dispositivo di puntamento sopra lo stesso InteractiveObject. Perché si verifichi un evento click, esso deve seguire sempre questa serie di eventi nell'ordine seguente: evento mouseDown, quindi mouseUp. L'oggetto target deve essere lo stesso per entrambi gli eventi, altrimenti l'evento click non si verifica. Tra gli eventi mouseDown o mouseUp può verificarsi qualsiasi numero di eventi del mouse in qualunque momento; l'evento click si verifica in ogni caso.

Questo evento ha le seguenti proprietà:

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. Perché si verifichi un evento doubleClick, esso deve seguire immediatamente la serie di eventi seguente: mouseDown, mouseUp, click, mouseDown, mouseUp. Tutti questi eventi devono avere la stessa destinazione dell'evento doubleClick. Il secondo clic, rappresentato dai secondi eventi mouseDown e mouseUp, deve verificarsi entro un intervallo di tempo specifico dopo l'evento click. La lunghezza consentita per questo intervallo varia a seconda del sistema operativo e può essere spesso configurata dall'utente. Se la destinazione è un campo di testo selezionabile, il comportamento predefinito è la selezione della parola che si trova sotto il puntatore. Se l'oggetto InteractiveObject di destinazione non ha il flag doubleClickEnabled impostato su true, riceve due eventi click.

La proprietà doubleClickEnabled è false per impostazione predefinita.

Il comportamento di selezione del testo mediante doppio clic di un oggetto TextField non è correlato all'evento doubleClick. Utilizzare TextField.doubleClickEnabled per controllare le selezioni TextField.

Questo evento ha le seguenti proprietà:

Vedere anche

Inviato dopo che un oggetto di visualizzazione ha ricevuto lo stato di attivazione. Questa situazione si verifica quando un utente evidenzia l'oggetto con un dispositivo di puntamento o mediante la tastiera. L'oggetto che riceve lo stato di attivazione è l'oggetto target di questo evento, mentre l'istanza InteractiveObject corrispondente che perde lo stato di attivazione è l'oggetto correlato. Un riferimento all'oggetto correlato viene memorizzato nella proprietà relatedObject dell'oggetto di destinazione. La proprietà shiftKey non viene utilizzata. Questo evento segue l'invio dell'evento focusOut dell'oggetto precedente.

Questo evento ha le seguenti proprietà:

Inviato dopo che un oggetto di visualizzazione ha perso lo stato di attivazione. Questa situazione si verifica quando un utente evidenzia un oggetto diverso con un dispositivo di puntamento o mediante la tastiera. L'oggetto che perde lo stato di attivazione è l'oggetto target di questo evento, mentre l'istanza InteractiveObject corrispondente che riceve lo stato di attivazione è l'oggetto correlato. Un riferimento all'oggetto correlato viene memorizzato nella proprietà relatedObject dell'oggetto target. La proprietà shiftKey non viene utilizzata. Questo evento precede l'invio dell'evento focusIn da parte dell'oggetto correlato.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente preme un tasto. Le mappature tra tasti e caratteri specifici variano a seconda del dispositivo e del sistema operativo. Questo tipo di evento viene generato dopo una tale mappatura ma prima dell'elaborazione di un IME (input method editor). Gli IME vengono utilizzati per immettere caratteri particolari, ad esempio gli ideogrammi cinesi, che la tastiera QWERTY standard non è adatta a produrre. Questo evento si verifica prima dell'evento keyUp.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando la tastiera. Il comportamento predefinito di questo evento è la modifica dello stato di attivazione e l'invio degli eventi focusIn e focusOut corrispondenti.

Questo evento viene inviato all'oggetto attivo. L'oggetto correlato a questo evento è l'istanza InteractiveObject che riceve l'attivazione se non si disabilita il comportamento predefinito. La modifica dello stato di attivazione può essere evitata chiamando il metodo preventDefault() su un listener di eventi correttamente registrato con l'oggetto target. Flash Player cambia lo stato di attivazione e invia gli eventi focusIn e focusOut come comportamento predefinito.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente rilascia un tasto. Le mappature tra tasti e caratteri specifici variano a seconda del dispositivo e del sistema operativo. Questo tipo di evento viene generato dopo una tale mappatura ma prima dell'elaborazione di un IME (input method editor). Gli IME vengono utilizzati per immettere caratteri particolari, ad esempio gli ideogrammi cinesi, che la tastiera QWERTY standard non è adatta a produrre. Questo evento si verifica dopo un evento keyDown e ha le seguenti caratteristiche:

Questo evento ha le seguenti proprietà:

Inviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject nella finestra di Flash Player. Se la destinazione è un'istanza SimpleButton, il comportamento predefinito dell'istanza è la visualizzazione dell'oggetto di visualizzazione downState. Se la destinazione è un campo di testo selezionabile, il comportamento predefinito è l'inizio della selezione nel campo di testo.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando un dispositivo di puntamento. Il comportamento predefinito di questo evento è la modifica dello stato di attivazione e l'invio degli eventi focusIn e focusOut corrispondenti.

Questo evento viene inviato all'oggetto attivo. L'oggetto correlato a questo evento è l'istanza InteractiveObject che riceve l'attivazione se non si disabilita il comportamento predefinito. La modifica dello stato di attivazione può essere evitata chiamando preventDefault() su un listener di eventi correttamente registrato con l'oggetto target. La proprietà shiftKey non viene utilizzata. Flash Player cambia lo stato di attivazione e invia gli eventi focusIn e focusOut come comportamento predefinito.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente sposta il dispositivo di puntamento mentre si trova sopra un'istanza InteractiveObject. Se la destinazione è un campo di testo che l'utente sta selezionando, il comportamento predefinito è l'aggiornamento della selezione.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject. La destinazione dell'evento è l'oggetto precedente che si trovava sotto il dispositivo di puntamento. relatedObject è l'oggetto sul quale si è spostato il dispositivo di puntamento. Se la destinazione è un'istanza SimpleButton, il comportamento predefinito dell'oggetto è la visualizzazione dell'oggetto di visualizzazione upState.

L'evento mouseOut viene inviato ogni volta che il mouse esce dall'area di qualunque oggetto secondario del contenitore di oggetto di visualizzazione, anche se il mouse rimane sopra un altro oggetto secondario del contenitore. Si tratta di un comportamento che non si addice allo scopo dell'evento rollOut, che è quello di semplificare la codifica dei comportamenti di rollover per i contenitori di oggetti di visualizzazione che includono elementi secondari. Quando il mouse esce dall'area di un oggetto di visualizzazione o dall'area di uno dei suoi elementi secondari per passare a un oggetto che non è uno dei suoi elementi secondari, l'oggetto di visualizzazione invia l'evento rollOut. Gli eventi rollOut vengono inviati consecutivamente verso l'alto lungo la catena di elementi superiori dell'oggetto, a partire da quell'oggetto e fino ad arrivare all'elemento superiore più alto che non sia né l'elemento principale né un antenato di relatedObject.

Questo evento ha le seguenti proprietà:

Inviato quando un utente muove un dispositivo di puntamento sopra un'istanza InteractiveObject nella finestra di Flash Player. relatedObject è l'oggetto precedente che si trovava sotto il dispositivo di puntamento. Se la destinazione è un'istanza SimpleButton, il comportamento predefinito dell'oggetto è la visualizzazione dell'oggetto di visualizzazione overState o upState, a seconda che il pulsante del mouse sia premuto o meno.

L'evento mouseOver viene inviato ogni volta che il mouse entra nell'area di qualunque oggetto secondario del contenitore di oggetto di visualizzazione, anche se il mouse si trovava già sopra un altro oggetto secondario del contenitore. Si tratta di un comportamento che non si addice allo scopo dell'evento rollOver, che è quello di semplificare la codifica dei comportamenti di rollout per i contenitori di oggetti di visualizzazione che includono elementi secondari. Quando il mouse entra nell'area di un oggetto di visualizzazione o di qualsiasi suo elemento secondario da un oggetto che non è un suo elemento secondario, l'oggetto di visualizzazione invia l'evento rollOver. Gli eventi rollOver vengono inviati consecutivamente verso il basso lungo la catena di elementi superiori dell'oggetto, a partire dall'elemento superiore più alto che non sia né l'elemento principale né un antenato di relatedObject e fino ad arrivare a quell'oggetto.

Questo evento ha le seguenti proprietà:

Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject nella finestra di Flash Player. Se la destinazione è un'istanza SimpleButton, l'oggetto visualizza l'oggetto di visualizzazione upState. Se la destinazione è un campo di testo selezionabile, il comportamento predefinito è la fine della selezione nel campo di testo.

Questo evento ha le seguenti proprietà:

Inviato quando la rotella del mouse viene fatta ruotare sopra un'istanza InteractiveObject nella finestra di Flash Player. Se la destinazione è un campo di testo, il comportamento predefinito del testo è lo scorrimento.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject. La destinazione dell'evento è l'oggetto precedente che si trovava sotto il dispositivo di puntamento o un elemento principale di tale oggetto. relatedObject è l'oggetto sul quale si è spostato il dispositivo di puntamento. Gli eventi rollOut vengono inviati consecutivamente verso l'alto lungo la catena di elementi superiori dell'oggetto, a partire da quell'oggetto e fino ad arrivare all'elemento superiore più alto che non sia né l'elemento principale né un antenato di relatedObject.

Lo scopo dell'evento rollOut è di semplificare la codifica dei comportamenti di rollover per i contenitori di oggetti di visualizzazione che includono elementi secondari. Quando il mouse esce dall'area di un oggetto di visualizzazione o di qualsiasi suo elemento secondario per spostarsi su un oggetto che non è un suo elemento secondario, l'oggetto di visualizzazione invia l'evento rollOut. Si tratta di un comportamento diverso da quello dell'evento mouseOut, che viene inviato ogni volta che il mouse esce dall'area di qualunque oggetto secondario del contenitore di oggetto di visualizzazione, anche se il mouse rimane sopra un altro oggetto secondario del contenitore.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject. La destinazione dell'evento è l'oggetto che si trova sotto il dispositivo di puntamento o un elemento principale di tale oggetto. relatedObject è l'oggetto precedente che si trovava sotto il dispositivo di puntamento. Gli eventi rollOver vengono inviati consecutivamente verso il basso lungo la catena di elementi superiori dell'oggetto, a partire dall'elemento superiore più alto che non sia né l'elemento principale né un antenato di relatedObject e fino ad arrivare a quell'oggetto.

Lo scopo dell'evento rollOver è di semplificare la codifica dei comportamenti di rollout per i contenitori di oggetti di visualizzazione che includono elementi secondari. Quando il mouse entra nell'area di un oggetto di visualizzazione o di qualsiasi suo elemento secondario da un oggetto che non è un suo elemento secondario, l'oggetto di visualizzazione invia l'evento rollOver. Si tratta di un comportamento diverso da quello dell'evento mouseOver, che viene inviato ogni volta che il mouse entra nell'area di qualunque oggetto secondario del contenitore di oggetto di visualizzazione, anche se il mouse si trovava già sopra un altro oggetto secondario del contenitore.

Questo evento ha le seguenti proprietà:

Inviato quando cambia il valore del flag tabChildren dell'oggetto.

Questo evento ha le seguenti proprietà:

Inviato quando cambia il flag tabEnabled dell'oggetto.

Questo evento ha le seguenti proprietà:

Inviato quando cambia il valore della proprietà tabIndex dell'oggetto.

Questo evento ha le seguenti proprietà:

1. Nella funzione di costruzione InteractiveObjectExample viene creato un nuovo oggetto ChildSprite di tipo Sprite di nome child, che chiama il metodo di costruzione ChildSprite per disegnare la forma e aggiungere degli eventi del mouse per la forma (come illustrato nella procedura seguente). L'oggetto child viene aggiunto in cima all'elenco di visualizzazione in corrispondenza delle coordinate x = 0, y = 0.
2. Nella classe ChildSprite, dichiarare le proprietà size e overSize che vengono successivamente utilizzate nel metodo draw() e nei metodi MouseEvent.
3. Dichiarare le proprietà che impostano l'arancione come colore dello sfondo, il giallo scuro come colore dello stato attivo di passaggio del mouse (mouse over) e il blu chiaro come colore dello stato premuto del mouse (mouse down).
4. Nella funzione di costruzione ChildSprite viene disegnato un quadrato arancione mediante i metodi della classe Graphics e il metodo draw().
5. La funzione di costruzione aggiunge quattro metodi del listener di eventi MouseEvent:
6. • mouseOverHandler: ridisegna un quadrato più grande con una dimensione di 60 x 60 pixel di colore giallo scuro in corrispondenza delle coordinate originali.
   • mouseOutHandler: ripristina le dimensioni e il colore originali del quadrato.
   • mouseDownHandler: ridisegna un quadrato più grande con una dimensione di 60 x 60 pixel di colore blu chiaro in corrispondenza delle coordinate originali.
   • mouseUpHandler: come mouseOverHandler.

package {
    import flash.display.Sprite;

    public class InteractiveObjectExample extends Sprite {

        public function InteractiveObjectExample() {
            var child:Sprite = new ChildSprite();
            addChild(child);
        }
    }
}

import flash.display.Sprite;
import flash.events.MouseEvent;

class ChildSprite extends Sprite {
    private var size:uint = 50;
    private var overSize:uint = 60;
    private var backgroundColor:uint = 0xFFCC00;
    private var overColor:uint = 0xCCFF00;
    private var downColor:uint = 0x00CCFF;

    public function ChildSprite() {
        buttonMode = true;
        draw(size, size, backgroundColor);
        addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
        addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
        addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
        addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
    }

    private function draw(w:uint, h:uint, bgColor:uint):void {
        graphics.clear();
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, w, h);
        graphics.endFill();
    }

    public function mouseOverHandler(event:MouseEvent):void {
        trace("mouseOverHandler");
        draw(overSize, overSize, overColor);
    }

    public function mouseOutHandler(event:MouseEvent):void {
        trace("mouseOutHandler");
        draw(size, size, backgroundColor);
    }

    public function mouseDownHandler(event:MouseEvent):void {
        trace("mouseDownHandler");
        draw(overSize, overSize, downColor);
    }

    public function mouseUpHandler(event:MouseEvent):void {
        trace("mouseUpHandler");
        draw(overSize, overSize, overColor);
    }
}