FocusManager  - AS3 Flash

Obtém ou define o botão padrão atual.

Um botão padrão é o botão em um formulário que despacha um evento click quando a tecla Enter é pressionada, dependendo de onde o foco está no momento.

Obtém ou define um valor que indica se o botão padrão está ativo. Se esse valor é definido como true, o gerenciador de foco monitora a tecla Enter e despacha um evento click no botão padrão se a tecla Enter for pressionada quando um componente que não é um componente Button tiver foco. Se esse valor é definido como false, o gerenciador de foco não monitora a tecla Enter. Os componentes que usam a tecla Enter definem essa propriedade como false para impedir que um evento click seja despachado no botão padrão, caso exista um, quando um usuário pressiona a tecla Enter.

Base DisplayObjectContainer para o IFocusManager, normalmente o palco.

Obtém o próximo índice de tabulação exclusivo a ser usado nessa repetição de tabulação.

Obtém ou define um valor que indica se um componente que possui foco deve ser marcado com um indicador visual de foco.

Cria uma nova ocorrência FocusManager.

Um gerenciador de foco gerencia o foco dentro dos filhos de um objeto DisplayObjectContainer.

Ativa a ocorrência FocusManager.

A ocorrência FocusManager adiciona manipuladores de eventos que permitem a monitoração da atividade do mouse e do teclado relacionada a foco.

Desativa a FocusManager.

A ocorrência FocusManager remove manipuladores de eventos que permitem a monitoração da atividade do mouse e do teclado relacionada a foco.

Recupera o objeto interativo que contém o objeto especificado, se houver. O player pode definir o foco para um subcomponente de um componente Flash; esse método determina que objeto interativo tem foco da perspectiva do componente.

Parâmetros

Obtém o objeto interativo que possui foco no momento. A Adobe recomenda que esse método seja chamado em vez de usar o objeto Stage, pois esse método indica que o componente tem foco. O Stage pode retornar um subcomponente nesse componente.

Recupera o objeto interativo que receberia o foco se o usuário tivesse pressionado a tecla Tab para navegar até o objeto seguinte. Esse método recuperará o objeto que possui foco no momento se não existir outros objetos válidos no aplicativo.

Parâmetros

Define o valor showFocusIndicator como false e remove o indicador de foco visual no objeto com foco, se houver.

Define o foco em um componente IFocusManagerComponent. Esse método não verifica a visibilidade do componente, o estado ativado ou outra condição.

Parâmetros

Define o valor de showFocusIndicator como true e desenha o indicador de foco visual no objeto com foco, se houver.

Para executar o exemplo, siga estas etapas:

1. Adicione o componente TextInput à biblioteca.
2. Salve esse código como FocusManagerExample.as no mesmo diretório de seu arquivo FLA.
3. Defina a classe Document no arquivo FLA file 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);
        }
    }
}