FocusManager  - AS3 Flash

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

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

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

IFocusManager の基本 DisplayObjectContainer で、通常はステージです。

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

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

新しい 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);
        }
    }
}