FocusManager  - AS3 Flash

Obtiene o define el botón predeterminado actual.

El botón predeterminado es el botón de un formulario que distribuye un evento click al presionar la tecla Intro, en función de la posición de la selección en ese momento.

Obtiene o define un valor que indica si el botón predeterminado está activado. Si este valor se define como true, Focus Manager controlará la tecla Intro y distribuirá un evento click en el botón predeterminado al presionar dicha tecla cuando esté seleccionado un componente que no sea botón. Si el valor se define como false, Focus Manager no controlará la tecla Intro. Los componentes que utilizan la tecla Intro establecen esta propiedad en false para evitar que se distribuya un evento click en el botón predeterminado (en caso de que exista) cuando el usuario presione dicha tecla.

DisplayObjectContainer base para IFocusManager, normalmente el escenario.

Obtiene el siguiente índice de tabulación único que se utiliza en este bucle de tabulación.

Obtiene o define un valor que indica si se debe marcar un componente seleccionado con un indicador visual de selección.

Crea una nueva instancia de FocusManager.

Focus Manager administra la selección en los elementos secundarios de un objeto DisplayObjectContainer.

Activa la instancia FocusManager.

La instancia FocusManager añade controladores de eventos que permiten supervisar la actividad del teclado y el ratón relacionada con la selección.

Desactiva la clase FocusManager.

La clase FocusManager quita los controladores de eventos que permiten controlar la actividad del teclado y el ratón relacionada con la selección.

Devuelve el objeto InteractiveObject que contiene el objeto dado, si existe. Flash Player puede establecer la selección en un subcomponente de un componente de Flash; este método determina qué objeto InteractiveObject está seleccionado desde el punto de vista del componente.

Parámetros

Obtiene el objeto interactivo que está seleccionado actualmente. Adobe recomienda llamar a este método en lugar de utilizar el objeto Stage, ya que este método indica qué componente está seleccionado. La clase Stage puede devolver un subcomponente de dicho componente.

Recupera el objeto InteractiveObject que se seleccionaría si el usuario presionara la tecla Tabulador para navegar al siguiente objeto. Este método devuelve el objeto seleccionado en ese momento si no hay otros objetos válidos en la aplicación.

Parámetros

Establece showFocusIndicator como false y quita el indicador de selección visual del objeto seleccionado, de haberlo.

Selecciona un componente IFocusManagerComponent. Este método no comprueba la visibilidad del componente, su estado de activación ni cualquier otra condición.

Parámetros

Establece showFocusIndicator como true y dibuja el indicador de selección visual en el objeto seleccionado, de haberlo.

Para realizar el ejemplo, siga estos pasos:

1. Añada el componente TextInput a la biblioteca.
2. Guarde este código como FocusManagerExample.as en el mismo directorio que el archivo FLA.
3. Defina la clase Document en el archivo FLA como 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);
        }
    }
}