| Package | fl.managers |
| Interface | public interface IFocusManagerComponent |
| Implémenteurs | Button, ColorPicker, ComboBox, DataGrid, LabelButton, List, NumericStepper, ScrollPane, SelectableList, Slider, TextArea, TextInput, TileList |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
La classe UIComponent offre une implémentation de base de cette interface mais ne l’implémente pas en intégralité, car tous les objets UIComponent ne reçoivent pas le focus. Les composants dérivés de la classe UIComponent doivent implémenter cette interface pour pouvoir recevoir le focus. Pour activer le focus, ajoutez l’instruction implements IFocusManagerComponent à la définition de classe d’un composant dérivé de la classe UIComponent.
Eléments de l’API associés
| Propriété | Défini par | ||
|---|---|---|---|
| focusEnabled : Boolean
Récupère ou définit une valeur booléenne indiquant si le composant sélectionné peut recevoir le focus du gestionnaire de focus. | IFocusManagerComponent | ||
| mouseFocusEnabled : Boolean [lecture seule]
Récupère une valeur booléenne indiquant si le composant sélectionné à l’aide d’une souris peut recevoir le focus. | IFocusManagerComponent | ||
| tabEnabled : Boolean [lecture seule]
Récupère une valeur booléenne qui indique si un appui sur la touche Tab peut déplacer le focus sur ce composant. | IFocusManagerComponent | ||
| tabIndex : int [lecture seule]
Récupère l’ordre dans lequel le composant reçoit le focus, si la propriété tabEnabled est définie sur true. | IFocusManagerComponent | ||
| Méthode | Défini par | ||
|---|---|---|---|
Dessine un indicateur de focus visuel. | IFocusManagerComponent | ||
Définit le focus pour un composant. | IFocusManagerComponent | ||
focusEnabled | propriété |
focusEnabled:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère ou définit une valeur booléenne indiquant si le composant sélectionné peut recevoir le focus du gestionnaire de focus.
Pour permettre à un composant de recevoir le focus du gestionnaire de focus, définissez cette propriété sur true. Pour empêcher un composant de recevoir le focus, définissez cette propriété sur false. Lorsque focusEnabled est défini sur false, le gestionnaire de focus ignore le composant pendant toute sa durée de vie et ne surveille pas les changements des propriétés suivantes : tabEnabled, tabChildren et mouseFocusEnabled.
Vous pouvez utiliser la propriété focusEnabled pour empêcher le composant enfant d’un composant implémentant l’interface IFocusManagerComponent de recevoir le focus du gestionnaire de focus. Pour ce faire, définissez cette propriété sur false avant de faire appel à la méthode addChild() pour ajouter le composant enfant à la liste d’affichage. Notez que si vous définissez cette propriété sur false avant d’ajouter le composant à la liste d’affichage, le gestionnaire de focus continuera d’ignorer le composant même si, par la suite, vous attribuez à cette propriété la valeur true.
Remarque : même si vous définissez cette propriété sur false, il vous reste la possibilité de définir le focus par programmation à l’aide de la méthode setFocus().
Implémentation
public function get focusEnabled():Boolean public function set focusEnabled(value:Boolean):voidmouseFocusEnabled | propriété |
mouseFocusEnabled:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère une valeur booléenne indiquant si le composant sélectionné à l’aide d’une souris peut recevoir le focus.
Définissez cette propriété sur true pour attribuer le focus aux composants sélectionnés à l’aide d’une souris. Définissez cette propriété sur false pour empêcher que le focus ne soit attribué aux composants sélectionnés à l’aide d’une souris. Si la valeur de cette propriété est false au moment où un composant est sélectionné à l’aide d’une souris, le focus est transféré au premier composant parent pour lequel cette propriété est définie sur true.
Implémentation
public function get mouseFocusEnabled():BooleantabEnabled | propriété |
tabEnabled:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère une valeur booléenne qui indique si un appui sur la touche Tab peut déplacer le focus sur ce composant. La valeur true indique que le fait d’appuyer sur la touche de tabulation peut provoquer le déplacement du focus sur ce composant ; la valeur false indique que la touche de tabulation ne peut pas être utilisée pour attribuer le focus à ce composant.
Même si cette valeur est définie sur false, le composant peut toujours recevoir le focus lorsqu’il est sélectionné avec la souris ou par un appel à la méthode setFocus().
Implémentation
public function get tabEnabled():BooleantabIndex | propriété |
tabIndex:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Récupère l’ordre dans lequel le composant reçoit le focus, si la propriété tabEnabled est définie sur true. La propriété tabIndex est définie sur -1 par défaut, ce qui signifie qu’aucun index de tabulation n’est défini pour cet objet et que celui-ci reçoit le focus selon l’ordre z.
La propriété tabIndex peut également être un entier non négatif. Dans ce cas, les objets sont triés selon leurs propriétés tabIndex, par ordre croissant. Un objet dont la valeur de tabIndex est définie sur 1 précède celui dont la valeur de tabIndex est 2. Si deux objets ont la même valeur au niveau de la propriété tabIndex, celui qui arrive en premier dans l’ordre de tabulation par défaut a la priorité sur l’autre.
La valeur par défaut est -1.
Implémentation
public function get tabIndex():intdrawFocus | () | méthode |
public function drawFocus(draw:Boolean):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Dessine un indicateur de focus visuel.
Cette méthode est appelée par le gestionnaire de focus lorsque le composant reçoit le focus. Le composant doit dessiner ou masquer un graphique qui indique qu’il a le focus.
Paramètres
draw:Boolean — Si la valeur est true, l’indicateur de focus est tracé, sinon il est masqué.
|
setFocus | () | méthode |
public function setFocus():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS3 |
| Versions du moteur d’exécution: | Flash Player 9.0.28.0, AIR 1.0 |
Définit le focus pour un composant.
Cette méthode est appelée par le gestionnaire de focus lorsque le composant reçoit le focus. Le composant peut à son tour attribuer le focus à un composant interne.
Tue Jun 12 2018, 09:30 AM Z