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):void
mouseFocusEnabled | 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():Boolean
tabEnabled | 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():Boolean
tabIndex | 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():int
drawFocus | () | 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