S > Selection.setFocus

Selection.setFocus

Disponibilité

Flash Player 5. Les noms d'occurrences de boutons et de champs de texte ne fonctionnent que dans Flash Player 6.

Usage

Selection.setFocus("cheminDeVariable")

Paramètres

cheminDeVariable Une chaîne spécifiant le chemin du nom d'une variable associée à un champ de texte.

Renvoie

Un événement.

Description

Méthode ; cible le champ de texte déroulante associé à la variable spécifiée par cheminDeVariable. Le paramètre cheminDeVariable doit être une chaîne littérale du chemin de cette variable. Vous pouvez utiliser la notation à point ou la notation à barre oblique pour spécifier le chemin. Vous pouvez également utiliser un chemin relatif ou absolu.

Si un chemin cible d'une occurrence de bouton est transmis au paramètre cheminDeVariable, ce bouton devient le nouveau focus. Si un chemin cible d'une occurrence de champ de texte est transmis au paramètre cheminDeVariable, ce champ de texte devient le nouveau focus. Si null est transmis, le focus actuel est retiré.

Si un clip de bouton est transmis à Selection.setFocus, ce bouton devient le focus actuel. Si un objet TextField est spécifié, il devient le focus actuel. Si un objet Button est spécifié, ce bouton devient le focus actuel.

Exemple

L'exemple suivant met le focus sur un champ de texte du scénario principal qui est associé à la variable maVar. Le paramètre cheminDeVariable est un chemin absolu, ce qui vous permet d'appeler l'action à partir de n'importe quel scénario.

Selection.setFocus("_root.maVar");

Dans l'exemple suivant, le champ de texte associé à maVar est dans un clip appelé monClip dans le scénario principal. Vous pouvez utiliser l'un ou l'autre des deux chemins suivants pour définir le focus, le premier étant relatif, le deuxième absolu.

Selection.setFocus("monClip.maVar");
Selection.setFocus("_root.monClip.maVar");