FocusManager  - AS3 Flash

Ottiene o imposta il pulsante predefinito corrente.

Il pulsante predefinito è il pulsante di un form che invia un evento click ogni volta che il tasto Invio viene premuto, a seconda di dove si trova in quel momento l'attivazione.

Ottiene o imposta un valore che indica se il pulsante predefinito è abilitato. Se questo valore è impostato su true, il gestore di attivazione esegue il monitoraggio del tasto Invio e invia un evento click al pulsante predefinito quando il tasto Invio viene premuto o quando viene attivato un componente che non è un componente Button. Se questo valore è impostato su false, il gestore di attivazione non esegue il monitoraggio del tasto Invio. Per i componenti che impiegano il tasto Invio, questa proprietà viene impostata su false per impedire che un evento click venga inviato al pulsante predefinito, se esistente, ogni volta che il tasto Invio viene premuto.

Contenitore DisplayObjectContainer di base per IFocusManager; solitamente è lo stage.

Ottiene il successivo indice di tabulazione univoco da utilizzare in questo ciclo di tabulazioni.

Ottiene o imposta un valore che indica se un componente attivo deve essere contrassegnato da un indicatore di attivazione visivo.

Crea una nuova istanza FocusManager.

Un gestore di attivazione gestisce l'attivazione tra gli elementi secondari di un oggetto DisplayObjectContainer.

Attiva l'istanza FocusManager.

L'istanza FocusManager aggiunge i gestori di eventi che consentono di monitorare l'attività della tastiera e del mouse correlata all'attivazione.

Disattiva il FocusManager.

FocusManager rimuove i gestori di eventi che consentono di monitorare l'attività della tastiera e del mouse correlata all'attivazione.

Recupera il l'oggetto interattivo che contiene l'oggetto specificato, se presente. Il player può rendere attivo un sottocomponente di un componente Flash, questo metodo determina quale oggetto interattivo è attivo dal punto di vista del componente.

Parametri

Ottiene l'oggetto interattivo che è l'elemento attivo corrente. Adobe consiglia di chiamare questo metodo anziché utilizzare l'oggetto Stage poiché questo metodo indica quale elemento è quello attivo. L'oggetto Stage talvolta può restituire un sottocomponente del componente.

Recupera l'oggetto interattivo che diventerebbe l'elemento attivo se l'utente premesse il tasto Tab per passare all'oggetto successivo. Questo metodo recupera l'oggetto che è l'elemento attivo corrente se nell'applicazione non ci sono altri oggetti validi.

Parametri

Imposta il valore showFocusIndicator su false e rimuove l'indicatore di attivazione visivo dall'oggetto attivo, se presente.

Imposta come elemento attivo un componente IFocusManagerComponent. Questo metodo non verifica la visibilità, lo stato di attivazione o altre condizioni del componente.

Parametri

Imposta il valore showFocusIndicator su true e disegna l'indicatore di attivazione visivo per l'oggetto attivo, se presente.

Per provare l'esempio, eseguite queste operazioni:

1. Aggiungete il componente TextInput alla libreria.
2. Salvate il codice come FocusManagerExample.as nella stessa directory del file FLA.
3. Impostate la classe documento nel file FLA su FocusManagerExample.

package
{
    import fl.controls.TextInput;
    import fl.managers.FocusManager;
    import flash.display.InteractiveObject;
    import flash.display.Sprite;
    import flash.events.*;
    import flash.utils.Timer;

    public class FocusManagerExample extends Sprite 
    {
        private var fm:FocusManager;
        
        public function FocusManagerExample() {
            buildGridOfTextInputs();

            fm = new FocusManager(this);
            var t:Timer = new Timer(1000);
            t.addEventListener(TimerEvent.TIMER,secondPassed);
            t.start();
        }
        private function buildGridOfTextInputs():void {
            var rowSpacing:uint = 30;
            var colSpacing:uint = 110;
            var totalRows:uint = 4;
            var totalCols:uint = 3;
            var i:uint;
            
            for(i = 0; i < totalRows * totalCols; i++) {
                var ti:TextInput = new TextInput()
                ti.name = "component"+i.toString();
                ti.addEventListener(FocusEvent.FOCUS_IN,focusChange);
                ti.setSize(100,20);
                ti.x = 10 + ((i % totalCols) * colSpacing);
                ti.y = 10 + (Math.floor(i / totalCols) * rowSpacing);
                ti.tabEnabled = true;
                addChild(ti);
            }
        }
        private function secondPassed(e:TimerEvent):void {
            var nextComponent:InteractiveObject = fm.getNextFocusManagerComponent();
            fm.setFocus(nextComponent);    
        }
        
        private function focusChange(e:FocusEvent):void {
            trace("Focus change: " + e.target.name);
        }
    }
}