Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
mx.managers 

IFocusManagerComponent  - AS3 Flex

Packagemx.managers
Interfacepublic interface IFocusManagerComponent
Implémenteurs AccessibleText, Accordion, AdvancedListBase, Button, ButtonBar, ButtonBar, ButtonBase, ChartBase, ComboBase, DataGrid, DateChooser, DateField, HTML, List, ListBase, MenuBar, NumericStepper, NumericStepper, OneLevelPanelNavigator, PanelItem, PromoImage, PromoSWFLoader, RadioButtonList, RichEditableText, Scroller, SkinnableTextBase, SliderBase, Spinner, TabBar, TabNavigator, TextArea, UIMovieClip, ViewMenu

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

L’interface IFocusManagerComponent définit l’interface qui doit être implémentée par les composants susceptibles d’avoir le focus de façon à recevoir le focus de FocusManager. Les principales implémentations de cette interface sont dans la classe UIComponent, bien que cette dernière n’implémente pas la totalité de l’interface IFocusManagerComponent, car certains UIComponents ne sont pas destinés à recevoir le focus. Donc, pour faire en sorte qu’un composant dérivé de la classe UIComponent puisse recevoir le focus, il vous suffit d’ajouter « implements IFocusManagerComponent » à la définition de la classe.



Propriétés publiques
 PropriétéDéfini par
  focusEnabled : Boolean
Indicateur qui signale si le composant peut recevoir le focus lorsqu’il est sélectionné.
IFocusManagerComponent
  hasFocusableChildren : Boolean
Indicateur qui signale si les objets enfant peuvent recevoir le focus
IFocusManagerComponent
  mouseFocusEnabled : Boolean
[lecture seule] Indicateur qui signale si le composant peut recevoir le focus lorsqu’il est sélectionné avec la souris.
IFocusManagerComponent
  tabFocusEnabled : Boolean
[lecture seule] Indicateur qui spécifie s’il est possible de déplacer le focus avec la touche de tabulation.
IFocusManagerComponent
  tabIndex : int
Si la valeur est tabFocusEnabled, l’ordre dans lequel le composant reçoit le focus.
IFocusManagerComponent
Méthodes publiques
 MéthodeDéfini par
  
Appelé par le FocusManager lorsque le composant reçoit le focus.
IFocusManagerComponent
  
Appelé par le FocusManager lorsque le composant reçoit le focus.
IFocusManagerComponent
Détails de la propriété

focusEnabled

propriété
focusEnabled: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 qui signale si le composant peut recevoir le focus lorsqu’il est sélectionné.

Pour optimiser votre application, si un composant enfant de votre composant implémente l’interface IFocusManagerComponent et que vous ne souhaitez jamais qu’il reçoive le focus, définissez focusEnabled sur false avant d’appeler la méthode addChild() sur le composant enfant.

Ainsi, la classe FocusManager ignorera ce composant et n’y surveillera pas le changement des propriétés tabFocusEnabled, tabChildren et mouseFocusEnabled. Cela implique également que vous ne pouvez pas changer cette valeur après l’appel de addChild() et espérer que le FocusManager s’en aperçoive.

Remarque : cela ne signifie pas que vous ne pouvez pas attribuer le focus à cet objet par programme dans votre méthode setFocus(), mais simplement que le FocusManager ignore ce composant IFocusManagerComponent dans ses recherches d’actions de souris et de tabulation.



Implémentation
    public function get focusEnabled():Boolean
    public function set focusEnabled(value:Boolean):void

hasFocusableChildren

propriété 
hasFocusableChildren:Boolean

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Indicateur qui signale si les objets enfant peuvent recevoir le focus

Remarque : cette fonction est similaire à la propriété tabChildren utilisée par Flash Player. Utilisez la propriété hasFocusableChildren avec les applications Flex. N’utilisez pas la propriété tabChildren.

La valeur de cette propriété est généralement false, car la plupart des composants reçoivent le focus ou le délèguent à un sous-composant interne unique et apparaissent comme s’ils avaient reçu le focus. Par exemple, un contrôle TextInput contient un contrôle RichEditableText enfant pouvant recevoir le focus, mais si le sous-composant RichEditableText reçoit le focus, le composant TextInput s’affiche comme s’il avait le focus. TextInput définit hasFocusableChildren sur false, car TextInput est considéré comme le composant ayant le focus. Sa structure interne est une abstraction.

Généralement, seuls les indicateurs des composants de navigateur tels que TabNavigator et Accordion sont définis sur true, car, bien qu’ils reçoivent le focus sur l’onglet, le focus est attribué aux composants des conteneurs enfant des onglets ultérieurs.

La valeur par défaut est false, sauf pour le composant spark.components.Scroller. Pour ce composant, la valeur par défaut est true.



Implémentation
    public function get hasFocusableChildren():Boolean
    public function set hasFocusableChildren(value:Boolean):void

mouseFocusEnabled

propriété 
mouseFocusEnabled:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Indicateur qui signale si le composant peut recevoir le focus lorsqu’il est sélectionné avec la souris. Si la valeur est false, le focus sera transféré au premier parent qui est mouseFocusEnabled.



Implémentation
    public function get mouseFocusEnabled():Boolean

tabFocusEnabled

propriété 
tabFocusEnabled:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Indicateur qui spécifie s’il est possible de déplacer le focus avec la touche de tabulation. Même si la valeur est false, vous pouvez recevoir le focus en sélectionnant avec la souris ou en appelant setFocus(). Cette propriété remplace InteractiveObject.tabEnabled qui doit être définie sur true dans Flex apps.



Implémentation
    public function get tabFocusEnabled():Boolean

tabIndex

propriété 
tabIndex:int

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Si la valeur est tabFocusEnabled, l’ordre dans lequel le composant reçoit le focus. Si la valeur est -1, le composant reçoit le focus en fonction de l’ordre z.



Implémentation
    public function get tabIndex():int
    public function set tabIndex(value:int):void
Détails de la méthode

drawFocus

()méthode
public function drawFocus(isFocused:Boolean):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Appelé par le FocusManager lorsque le composant reçoit le focus. Le composant doit dessiner ou masquer un graphique qui indique qu’il a le focus.

Paramètres

isFocused: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: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Appelé par le FocusManager lorsque le composant reçoit le focus. Le composant peut à son tour attribuer le focus à un composant interne.





[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.