FocusManager  - AS3 Flash

Obtient ou définit le bouton par défaut actuel.

Le bouton par défaut correspond au bouton d’un formulaire qui distribue un événement click lorsque l’utilisateur appuie sur la touche Entrée, en fonction de l’emplacement du focus à cet instant.

Récupère ou définit une valeur indiquant si le bouton par défaut est activé. Si cette valeur est définie sur true, le gestionnaire de focus surveille la touche Entrée et distribue un événement click au bouton par défaut si l’utilisateur appuie sur la touche Entrée au moment où un composant autre qu’un bouton détient le focus. Si cette valeur est définie sur false, le gestionnaire de focus ne surveille pas la touche Entrée. Les composants qui utilisent la touche Entrée définissent cette propriété sur false pour empêcher la distribution d’un événement click sur le bouton par défaut, dans le cas où il en existe un, lorsque l’utilisateur appuie sur la touche Entrée.

DisplayObjectContainer de base pour IFocusManager, généralement la scène.

Récupère le prochain index de tabulation unique à utiliser dans cette boucle de tabulation.

Récupère ou définit une valeur qui indique si un composant qui a le focus doit recevoir un indicateur visuel de focus.

Crée une nouvelle occurrence de FocusManager.

Un gestionnaire de focus gère le focus au sein des enfants d’un objet DisplayObjectContainer.

Active l’occurrence de FocusManager.

L’occurrence FocusManager ajoute des gestionnaires d’événement qui lui permettent de surveiller les actions de la souris et du clavier en relation avec le focus.

Désactive le FocusManager.

Le FocusManager supprime les gestionnaires d’événement qui lui permettent de surveiller les actions de la souris et du clavier en relation avec le focus.

Récupère l’objet interactif qui contient l’objet donné, le cas échéant. Le lecteur pouvant attribuer le focus à un sous-composant d’un composant Flash, cette méthode identifie l’objet interactif qui a le focus du point de vue du composant.

Paramètres

Récupère l’objet interactif qui détient actuellement le focus. Adobe conseille d’appeler cette méthode plutôt que d’utiliser l’objet Stage, car cette méthode indique le composant qui a le focus. L’objet Stage risque de renvoyer un sous-composant dans ce composant.

Récupère l’objet interactif qui recevrait le focus si l’utilisateur appuyait sur la touche de tabulation pour accéder à l’objet suivant. Cette méthode récupère l’objet qui détient actuellement le focus s’il n’y a pas d’autre objet valide dans l’application.

Paramètres

Définit la valeur de showFocusIndicator sur false et supprime l’indicateur de focus visuel de l’objet qui a le focus, le cas échéant.

Définit le focus sur un composant IFocusManagerComponent. Cette méthode ne vérifie ni la visibilité du composant, ni son état activé, ni aucune autre condition.

Paramètres

Définit la valeur de showFocusIndicator sur true et dessine l’indicateur de focus visuel sur l’objet qui a le focus, le cas échéant.

Pour exécuter l’exemple, suivez ces étapes :

1. Ajoutez le composant TextInput à la bibliothèque.
2. Enregistrez ce code sous le nom FocusManagerExample.as dans le même répertoire que votre fichier FLA.
3. Dans le fichier FLA, définissez la classe Document sur 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);
        }
    }
}