現在のデフォルトボタンを取得または設定します。

デフォルトボタンは、Enter キーが押されると、そのときフォーカスがどこにあるかに応じて click イベントを送出する、フォーム上のボタンです。

デフォルトのボタンが有効かどうかを示す値を取得または設定します。この値が true に設定されていると、フォーカスマネージャは Enter キーを監視して、ボタンコンポーネント以外のコンポーネントにフォーカスがあるときに Enter キーが押された場合に、デフォルトボタンに対して click イベントを送出します。この値が false に設定されていると、フォーカスマネージャは Enter キーを監視しません。Enter キーを使用するコンポーネントでは、このプロパティを false に設定して、ユーザーが Enter キーを押したときにデフォルトのボタン (存在する場合) に対して click イベントが送出されることを回避します。

このタブループで次に使用する固有のタブインデックスを取得します。

フォーカスのあるコンポーネントをフォーカスの可視インジケータでマークするかどうかを示す値を取得または設定します。

新しい FocusManager インスタンスを作成します。

フォーカスマネージャは、DisplayObjectContainer オブジェクトの子の中でフォーカスを管理します。

FocusManager インスタンスをアクティブにします。

FocusManager インスタンスは、イベントハンドラを追加して、フォーカスに関連したキーボード操作とマウス操作を監視できるようにします。

FocusManager を非アクティブ化します。

FocusManager では、フォーカスに関連するキーボードやマウスの操作を監視できるイベントハンドラを削除します。

指定されたオブジェクトが含まれているインタラクティブオブジェクト (存在する場合) を取得します。プレーヤーでは Flash コンポーネントのサブコンポーネントにフォーカスを設定できます。このメソッドでは、コンポーネント側から見てどのインタラクティブオブジェクトにフォーカスがあるかを判別します。

パラメータ

現在フォーカスを持っているインタラクティブオブジェクトを取得します。このメソッドを呼び出すと、どのコンポーネントにフォーカスがあるかが示されるので、Stage オブジェクトよりもこのメソッドを使用することをお勧めします。Stage オブジェクトは、該当コンポーネント内のサブコンポーネントを返す場合があります。

ユーザーが Tab キーを押して次のオブジェクトに移動すると、フォーカスを受け取るインタラクティブオブジェクトを取得します。このメソッドは、アプリケーション内に他に有効なオブジェクトがなければ、現在フォーカスを持っているオブジェクトを取得します。

パラメータ

showFocusIndicator 値を false に設定し、フォーカスがあるオブジェクト (存在する場合) から可視のフォーカスインジケータを削除します。

フォーカスを IFocusManagerComponent コンポーネントに設定します。このメソッドでは、コンポーネントの可視性、有効にされた状態またはその他の条件については、チェックされません。

パラメータ

showFocusIndicator 値を true に設定し、フォーカスがあるオブジェクト (存在する場合) に可視のフォーカスインジケータを描画します。

例を実行するには、次の手順に従います。

1. TextInput コンポーネントをライブラリに追加します。
2. このコードを FLA ファイルと同じディレクトリに FocusManagerExample.as という名前で保存します。
3. FLA ファイル内の Document クラスを 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);
        }
    }
}