Disponibilité

Flash Player 6 (6.0.79.0).

Edition

Flash MX Professional 2004.

Utilisation

myScreen.currentFocusedScreen

Description

Propriété statique (lecture seule) ; renvoie une référence à l'objet d'écran le plus éloigné dans l'arborescence contenant le focus global actuel. Leafmost se réfère à l'écran le plus éloigné de l'écran racine dans la hiérarchie d'écrans. Le focus peut se trouver sur l'écran lui-même ou sur un clip, un objet texte ou un composant à l'intérieur de l'écran. Cette propriété prend la valeur null par défaut s'il n'y a aucun focus actuel.

Par exemple, supposons que vous avez une hiérarchie d'écrans d'exécution ayant l'aspect suivant :

presentation
    screen1
        subscreen1_1
            mymovieclip
                myUIButton

    screen2
        subscreen1_2

Si myUIButton a le focus, l'écran le plus éloigné contenant le focus est subscreen1_1, qui correspond à ce que currentFocusedScreen renvoie. Dans ce cas, presentation, screen1 et subscreen1_1 contiennent le focus, mais celui se trouvant « le plus près » (dans la hiérarchie d'écrans) des feuilles de l'arborescence (c'est-à-dire le plus loin de la racine) est subscreen1_1.

Exemple

L'exemple suivant affiche le nom de l'écran ayant actuellement le focus dans le panneau Sortie.

var currentFocus:mx.screens.Screen = mx.screens.Screen.currentFocusedScreen;
trace("Current screen is: " + currentFocus._name);