FocusManager  - AS3 Flash

Определяет или задает текущую кнопку по умолчанию.

Кнопка по умолчанию  это кнопка на форме, которая отправляет событие click при нажатии клавиши Enter, в зависимости от положения фокуса в данный момент.

Возвращает или устанавливает значение, указывающее, разрешена ли кнопка по умолчанию. Если данное свойство имеет значение true то диспетчер фокуса следить за клавишей Enter. При нажатии клавиши Enter в то время, когда имеет фокус компонент, не являющийся компонентом Button, диспетчер фокуса отправляет событие click на кнопку по умолчанию Если данное свойство имеет значение false, то диспетчер фокуса не следит за клавишей Enter. Компонент, использующий клавишу Enter, устанавливает для данного свойства значение false для предотвращения отправки события click в кнопку по умолчанию, когда пользователь нажимает клавишу Enter.

Базовый контейнер DisplayObjectContainer для объекта IFocusManager, обычно рабочая область.

Определяет следующий уникальный индекс при переходе с помощью клавиши Tab для использования в этом цикле табуляции.

Определяет или задает значение, указывающее, должен ли компонент в фокусе выделяться визуальным индикатором фокуса.

Создает новый экземпляр FocusManager.

Диспетчер фокуса управляет фокусом внутри дочернего объекта DisplayObjectContainer.

Активирует экземпляр FocusManager.

Экземпляр FocusManager добавляет обработчик событий, позволяющий наблюдать активность клавиатуры и мыши, связанную с фокусом.

Деактивирует FocusManager.

Экземпляр FocusManager удаляет обработчик событий, позволяющий наблюдать активность клавиатуры и мыши, связанную с фокусом.

Возвращает интерактивный объект, содержащий данный объект, если таковой существует. Проигрыватель может установить фокус на подкомпонент компонента Flash. Данный метод определяет, какой интерактивный объект компонента имеет фокус с точки зрения компонента.

Параметры

Определяет интерактивный объект, который в настоящий момент имеет фокус. Adobe рекомендует вызывать данный метод вместо использования объекта Stage, потому что данный метод показывает, какой объект имеет фокус. Рабочая область может вернуть субкомпонент в этом компоненте.

Возвращает интерактивный объект, который получает фокус, когда пользователь нажимает клавишу TAB для перехода к следующему объекту. Данный метод находит объект, который в настоящий момент имеет фокус, если в приложении нет других доступных объектов.

Параметры

Задает для свойства showFocusIndicator значение false и удаляет визуальный индикатор фокуса с объекта, имеющего фокус (если такой существует).

Задает фокус на компоненте IFocusManagerComponent. Данный метод не проверяет видимость компонента, включенное состояние или любые другие условия.

Параметры

Присваивает свойству showFocusIndicator значение true и рисует визуальный индикатор фокуса на объекте, находящемся в фокусе (если такой существует).

Чтобы применить этот пример на практике, выполните следующие действия.

1. Добавьте компонент TextInput в библиотеку.
2. Сохраните этот код под именем FocusManagerExample.as в том же каталоге, где и FLA-файл.
3. Присвойте классу Document в FLA-файле значение 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);
        }
    }
}