FocusManager  - AS3 Flash

Ruft die aktuelle Standardschaltfläche ab oder legt diese fest.

Eine Standardschalfläche ist die Schaltfläche auf einem Formular, durch die ein click-Ereignis ausgelöst wird, wenn die Eingabetaste gedrückt wird, je nachdem, wo sich der Fokus zu diesem Zeitpunkt befindet.

Ruft einen Wert auf oder stellt einen Wert ein, der angibt, ob die Standardschaltfläche aktiviert ist. Wenn dieser Wert auf true gesetzt wird, überwacht der Focus Manager die Eingabetaste und löst ein click-Ereignis für die Standardschaltfläche aus, wenn die Eingabetaste gedrückt wird und eine Komponente, bei der es sich nicht um eine Schaltfläche handelt, über den Fokus verfügt. Wenn der Wert auf false gesetzt ist, wird die Eingabetaste nicht vom Focus Manager überwacht. Komponenten, die die Eingabetaste verwenden, setzen diese Eigenschaft auf false, um zu verhindern, dass für die Standardschaltfläche, sofern vorhanden, ein click-Ereignis ausgelöst wird, sobald ein Benutzer die Eingabetaste drückt.

Base DisplayObjectContainer für den IFocusManager, normalerweise die Bühne.

Ruft den nächsten eindeutigen Tabulatorindex auf, der in der aktuellen Tabulatorschleife verwendet werden soll.

Ruft einen Wert ab, der angibt, ob eine Komponente mit dem Fokus durch einen visuellen Indikator gekennzeichnet wird, oder legt diesen fest.

Erstellt eine neue FocusManager-Instanz.

Ein Focus Manager verwaltet den Fokus für die untergeordneten Objekte eines DisplayObjectContainer-Objekts.

Aktiviert die FocusManager-Instanz.

Die FocusManager-Instanz fügt Ereignisprozeduren hinzu, mit denen fokusrelevante Tastatur- und Mauseingaben überwacht werden können.

Deaktiviert den FocusManager.

Der FocusManager entfernt Ereignisprozeduren, mit denen fokusrelevante Tastatur- und Mauseingaben überwacht werden können.

Ruft das interaktive Objekt auf, das das entsprechende Objekt enthält, sofern vorhanden. Der Player kann den Fokus auf eine Unterkomponente einer Flash-Komponente legen. Durch diese Methode wird ermittelt, welches interaktive Objekt vom Blickwinkel der Komponente aus über den Fokus verfügt.

Parameter

Ruft das interaktive Objekt ab, auf dem derzeit der Fokus liegt. Verwenden Sie vorzugsweise diese Methode anstelle des Stage-Objekts, da hier angegeben wird, auf welcher Komponente der Fokus liegt. Das Stage-Objekt gibt unter Umständen eine Unterkomponente in der Komponente zurück.

Ruft das interaktive Objekt auf, das den Fokus erhielte, sofern der Benutzer die Tabulatortaste drückt, um zum nächsten Objekt zu navigieren. Durch diese Methode wird das Objekt zurückgegeben, auf dem derzeit der Fokus liegt, wenn die Anwendung keine weiteren gültigen Objekte enthält.

Parameter

Setzt den showFocusIndicator-Wert auf false und entfernt den sichtbaren Fokusindikator ggf. von dem Objekt, das gegenwärtig den Fokus besitzt.

Legt den Fokus auf eine IFocusManagerComponent-Komponente. Die Sichtbarkeit, der Aktivierungsstatus und andere Bedingungen der Komponente werden mit dieser Methode nicht überprüft.

Parameter

Setzt den showFocusIndicator-Wert auf true und zeichnet einen sichtbaren Fokusindikator auf dem Objekt, das gegenwärtig den Fokus besitzt (sofern vorhanden).

Gehen Sie wie folgt vor, um das Beispiel auszuführen:

1. Fügen Sie die TextInput-Komponente zur Bibliothek hinzu.
2. Speichern Sie diesen Code als "FocusManagerExample.as" im gleichen Verzeichnis wie die FLA-Datei.
3. Legen Sie in der FLA-Datei die Dokumentklasse "FocusManagerExample" fest.

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);
        }
    }
}