Utilisation du composant TextArea

Un composant TextArea peut être activé ou désactivé dans une application. Lorsqu’il est désactivé, il ne reçoit pas les entrées en provenance de la souris ou du clavier. Lorsqu’il est activé, il suit les mêmes règles de focus, de sélection et de navigation qu’un objet TextField ActionScript. Lorsque l’occurrence d’un composant TextArea a le focus, vous pouvez la contrôler à l’aide des touches suivantes.

Pour plus d’informations sur le contrôle du focus, voir la classe FocusManager dans le Guide de référence d’ActionScript 3.0 pour Flash Professional et Utilisation de FocusManager .

Dans l’Inspecteur des propriétés ou l’Inspecteur des composants, vous pouvez définir les paramètres de création suivants pour chaque occurrence du composant TextArea : condenseWhite , editable , hortizontalScrollPolicy , maxChars , restrict , text , verticalScrollPolicy et wordwrap . A chacun de ces paramètres correspond une propriété ActionScript du même nom. Pour plus d’informations sur les valeurs gérées de ces paramètres, voir la classe TextArea dans le Guide de référence d’ActionScript 3.0 pour Flash Professional .

Un aperçu en direct de chaque occurrence de TextArea reflète les modifications effectuées sur les paramètres dans l’Inspecteur des propriétés ou l’Inspecteur des composants pendant la programmation. Si une barre de défilement s’avère nécessaire, elle apparaît lors d’un aperçu en direct, mais ne fonctionnera pas. Lors d’un aperçu en direct, il n’est pas possible de sélectionner du texte et vous ne pouvez pas entrer de texte dans l’occurrence du composant sur la scène.

Vous pouvez contrôler ces options et d’autres options du composant TextArea à l’aide des propriétés, méthodes et événements d’ActionScript. Pour plus d’informations, voir la classe TextArea dans le Guide de référence d’ActionScript 3.0 pour Flash Professional .

La procédure suivante explique comment ajouter un composant TextArea à une application pendant la programmation. L’exemple configure un gestionnaire d’événements focusOut sur l’occurrence de TextArea qui vérifie que l’utilisateur a tapé des données dans la zone de texte avant de donner le focus à une autre partie de l’interface.

1. Créez un document Flash (ActionScript 3.0).

2. Faites glisser un composant TextArea du panneau Composants vers la scène et nommez l’occurrence aTa . Conservez les réglages par défaut de ses paramètres.

3. Faites glisser un second composant TextArea du panneau Composants sur la scène, placez-le sous le premier et nommez son occurrence bTa . Conservez les réglages par défaut de ses paramètres.

4. Ouvrez le panneau Actions, sélectionnez l’image 1 dans le scénario principal et entrez le code ActionScript suivant :

   import flash.events.FocusEvent; 
    
   aTa.restrict = "a-z,'\" \""; 
   aTa.addEventListener(Event.CHANGE,changeHandler); 
   aTa.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, k_m_fHandler); 
   aTa.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, k_m_fHandler); 
    
   function changeHandler(ch_evt:Event):void { 
       bTa.text = aTa.text; 
   } 
   function k_m_fHandler(kmf_event:FocusEvent):void { 
       kmf_event.preventDefault(); 
   }

   Cet exemple limite les caractères que vous pouvez entrer dans la zone de texte aTa aux minuscules, à la virgule, à l’apostrophe et aux espaces. Il définit également des gestionnaires d’événements pour les événements change , KEY_FOCUS_CHANGE et MOUSE_FOCUS_CHANGE sur la zone de texte aTa . La fonction changeHandler() force le texte que vous entrez dans la zone de texte aTa à s’afficher automatiquement dans la zone bTa , en attribuant aTa.text à bTa.text lors de chaque événement change . La fonction k_m_fHandler() des événements KEY_FOCUS_CHANGE et MOUSE_FOCUS_CHANGE vous empêche d’appuyer sur la touche Tab pour passer à la zone suivante si vous n’avez pas entré de texte. Pour ce faire, cette fonction interdit le comportement par défaut.

5. Choisissez Contrôle > Tester l’animation.

   Si vous appuyez sur la touche Tab pour déplacer le focus sur la seconde zone de texte alors que vous n’avez pas entré de texte, un message d’erreur doit s’afficher, et le focus doit revenir à la première zone de texte. Lorsque vous entrez du texte dans la première zone, vous verrez qu’il est copié dans la seconde.