| Package | mx.managers |
| Classe | public class FocusManager |
| Héritage | FocusManager  EventDispatcher Object |
| Implémente | IFocusManager |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
L’objet FocusManager gère le focus à partir du « niveau du composant ». Dans Flex, un objet UITextField dans un composant est la seule façon d’autoriser la saisie de texte par clavier. Pour Flash Player ou AIR, cet objet UITextField a le focus. Toutefois, du point de vue de l’objet FocusManager, le composant qui est le parent de l’objet UITextField a le focus. Ainsi, il existe une distinction entre le focus au niveau du composant et le focus de niveau Player. Les développeurs d’application ne sont généralement confrontés qu’au focus au niveau du composant, tandis que les développeurs de composant doivent comprendre le focus de niveau Player.
Tous les composants qui peuvent être gérés par le FocusManager doivent implémenter la classe mx.managers.IFocusManagerComponent, alors que les objets gérés par le focus de niveau Player n’ont pas à le faire.
L’objet FocusManager gère également le concept d’un defaultButton : objet Button placé sur un formulaire et qui distribue un événement click lorsque l’utilisateur appuie sur la touche Entrée, selon l’emplacement du focus à ce moment-là.
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| defaultButton : IButton
Référence au contrôle Button par défaut d’origine. | FocusManager | ||
| defaultButtonEnabled : Boolean
Un indicateur qui spécifie si l’objet FocusManager doit confirmer l’utilisation de la touche Entrée pour activer le bouton par défaut. | FocusManager | ||
| focusPane : Sprite
Sprite unique qui est déplacé de conteneur en conteneur au fur et à mesure que le focus arrive sur ces conteneurs. | FocusManager | ||
| nextTabIndex : int [lecture seule]
Prochain et unique index de tabulation à utiliser dans cette boucle de tabulation. | FocusManager | ||
| showFocusIndicator : Boolean
Indicateur précisant si le composant avec focus doit faire l’objet d’une indication visuelle. | FocusManager | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | FocusManager | ||
Le SystemManager active et désactive un FocusManager si plusieurs IFocusManagerContainer sont visibles simultanément. | FocusManager | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
Le SystemManager active et désactive un FocusManager si plusieurs IFocusManagerContainer sont visibles simultanément. | FocusManager | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
Renvoie le composant IFocusManagerComponent qui contient l’objet donné, le cas échéant. | FocusManager | ||
Récupère le composant IFocusManagerComponent qui a le focus actuellement. | FocusManager | ||
Renvoie le composant IFocusManagerComponent qui recevrait le focus si l’utilisateur appuyait sur la touche de tabulation pour accéder à un autre composant. | FocusManager | ||
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
Définit la valeur de showFocusIndicator sur false et supprime l’indicateur de focus visuel sur l’objet qui a le focus, le cas échéant. | FocusManager | ||
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
Attribue le focus à un composant IFocusManagerComponent. | FocusManager | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
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. | FocusManager | ||
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
[override]
Renvoie une représentation de chaîne du composant qui héberge l’objet FocusManager. « .focusManager » est ajouté à la fin de la chaîne. | FocusManager | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
defaultButton | propriété |
defaultButton:IButton| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Référence au contrôle Button par défaut d’origine. L’activation de la touche Entrée pendant que le focus est sur un contrôle quelconque active le contrôle Button en distribuant un événement click sur le contrôle Button, comme s’il avait reçu un clic de souris. Le véritable contrôle Button par défaut change si le focus est attribué à un autre contrôle Button, mais revient au contrôle d’origine si le focus n’est pas sur un bouton.
Cette propriété étant gérée par les conteneurs Flex, ne la définissez pas directement pour spécifier le bouton par défaut.
L’objet defaultButton doit appartenir à la classe mx.controls.Button, même si cette propriété est de type IUIComponent.
Implémentation
public function get defaultButton():IButton public function set defaultButton(value:IButton):voiddefaultButtonEnabled | propriété |
defaultButtonEnabled:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Un indicateur qui spécifie si l’objet FocusManager doit confirmer l’utilisation de la touche Entrée pour activer le bouton par défaut. TextArea et d’autres composants voulant reconnaître la touche Entrée définissent cette propriété sur false pour empêcher la touche Entrée de distribuer un événement click sur le bouton défaut, s’il existe.
Implémentation
public function get defaultButtonEnabled():Boolean public function set defaultButtonEnabled(value:Boolean):voidfocusPane | propriété |
focusPane:Sprite| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Sprite unique qui est déplacé de conteneur en conteneur au fur et à mesure que le focus arrive sur ces conteneurs. L’objet Sprite est utilisé en tant que parent de l’indicateur visuel, qui signale qu’un composant a le focus.
Implémentation
public function get focusPane():Sprite public function set focusPane(value:Sprite):voidnextTabIndex | propriété |
showFocusIndicator | propriété |
showFocusIndicator:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indicateur précisant si le composant avec focus doit faire l’objet d’une indication visuelle. Si la valeur est true, un composant qui reçoit le focus trace un indicateur visible pour signaler qu’il a le focus.
Par défaut, cette valeur est false jusqu’à ce que l’utilisateur appuie sur la touche de tabulation ; elle est ensuite définie sur true.
En général, il est préférable d’utiliser les méthodes showFocus() et hideFocus() pour modifier cette propriété, car elles mettent également à jour l’indicateur visuel signalant qu’un composant a le focus.
Implémentation
public function get showFocusIndicator():Boolean public function set showFocusIndicator(value:Boolean):voidFocusManager | () | Constructeur |
public function FocusManager(container:IFocusManagerContainer, popup:Boolean = false)| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
Un objet FocusManager gère le focus au sein des enfants d’un objet IFocusManagerContainer. Il s’installe dans l’objet IFocusManagerContainer à l’exécution du constructeur.
Paramètrescontainer:IFocusManagerContainer — Objet IFocusManagerContainer qui héberge l’objet FocusManager.
| |
popup:Boolean (default = false)true, indique que le conteneur est un composant contextuel et non l’application principale.
|
activate | () | méthode |
public function activate():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Le SystemManager active et désactive un FocusManager si plusieurs IFocusManagerContainer sont visibles simultanément. Si un utilisateur clique dans un objet IFocusManagerContainer avec un objet FocusManager désactivé, l’objet SystemManager appelle la méthode activate() sur cet objet FocusManager. La méthode deactivate() de l’objet FocusManager qui a été activé est appelée avant l’activation d’un autre objet FocusManager.
L’objet FocusManager ajoute les gestionnaires d’événement qui lui permettent de surveiller les actions de la souris et du clavier en relation avec le focus.
deactivate | () | méthode |
public function deactivate():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Le SystemManager active et désactive un FocusManager si plusieurs IFocusManagerContainer sont visibles simultanément. Si un utilisateur clique dans un objet IFocusManagerContainer avec un objet FocusManager désactivé, l’objet SystemManager appelle la méthode activate() sur cet objet FocusManager. La méthode deactivate() de l’objet FocusManager qui a été activé est appelée avant l’activation d’un autre objet 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.
findFocusManagerComponent | () | méthode |
public function findFocusManagerComponent(o:InteractiveObject):IFocusManagerComponent| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie le composant IFocusManagerComponent qui contient l’objet donné, le cas échéant. Flash Player pouvant attribuer le focus à un sous-composant d’un composant Flex, cette méthode identifie le composant IFocusManagerComponent qui a le focus du point de vue du composant.
Paramètres
o:InteractiveObject — Objet pouvant avoir le focus de niveau Flash Player.
|
IFocusManagerComponent — Composant IFOcusManagerComponent contenant o ou null
|
getFocus | () | méthode |
public function getFocus():IFocusManagerComponent| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Récupère le composant IFocusManagerComponent qui a le focus actuellement. Il est conseillé d’appeler cette méthode plutôt que d’utiliser l’objet Stage, car elle indique quel composant a le focus. L’objet Stage risque de renvoyer un sous-composant dans ce composant.
Valeur renvoyéeIFocusManagerComponent — Objet IFocusManagerComponent qui a le focus.
|
getNextFocusManagerComponent | () | méthode |
public function getNextFocusManagerComponent(backward:Boolean = false):IFocusManagerComponent| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie le composant IFocusManagerComponent qui recevrait le focus si l’utilisateur appuyait sur la touche de tabulation pour accéder à un autre composant. Il renverra le même composant que celui qui a actuellement le focus si l’application ne comporte aucun autre composant valide.
Paramètres
backward:Boolean (default = false)true, renvoie l’objet résultant de l’activation des touches Maj-Tab.
|
IFocusManagerComponent — Composant susceptible de recevoir le focus.
|
hideFocus | () | méthode |
public function hideFocus():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Définit la valeur de showFocusIndicator sur false et supprime l’indicateur de focus visuel sur l’objet qui a le focus, le cas échéant.
setFocus | () | méthode |
public function setFocus(o:IFocusManagerComponent):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Attribue le focus à un composant IFocusManagerComponent. Ne vérifie pas ni visibilité du composant, ni son état activé, ni aucune autre condition.
Paramètres
o:IFocusManagerComponent — Composant qui peut recevoir le focus.
|
showFocus | () | méthode |
public function showFocus():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
toString | () | méthode |
override public function toString():String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie une représentation de chaîne du composant qui héberge l’objet FocusManager. ".focusManager" est ajouté à la fin de la chaîne.
String — Renvoie une représentation de chaîne du composant qui héberge l’objet FocusManager. ".focusManager" est ajouté à la fin de la chaîne.
|
Tue Jun 12 2018, 09:30 AM Z