Utilisation du composant ComboBox

Vous pouvez utiliser un composant ComboBox dans tout formulaire ou toute application qui requiert un choix unique dans une liste. Par exemple, vous pouvez fournir une liste déroulante de pays dans un formulaire où les clients doivent saisir leur adresse. Les composants ComboBox modifiables conviennent pour des scénarios plus complexes. Par exemple, dans une application d’itinéraire routier, utilisez un composant ComboBox modifiable pour que l’utilisateur y saisisse ses adresses de départ et d’arrivée. La liste déroulante pourrait alors contenir des adresses déjà saisies.

Si le composant ComboBox est modifiable, ce qui signifie que la propriété editable est définie sur true , les touches suivantes retirent le focus de la zone de saisie de texte et conservent la valeur précédente. La touche Entrée constitue une exception car elle applique la nouvelle valeur d’abord, si l’utilisateur a entré du texte.

Lorsque vous ajoutez un composant ComboBox à une application, vous pouvez le rendre accessible à un lecteur d’écran en ajoutant les lignes de code ActionScript suivantes :

import fl.accessibility.ComboBoxAccImpl; 
 
ComboBoxAccImpl.enableAccessibility();

Quel que soit le nombre d’occurrences du composant, l’activation de son accessibilité ne se fait qu’une fois.

Dans l’Inspecteur des propriétés ou l’Inspecteur des composants, vous pouvez définir les paramètres suivants pour chaque occurrence de ComboBox : dataProvider , editable , prompt et rowCount . 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 ComboBox dans le Guide de référence d’ActionScript 3.0 pour Flash Professional . Pour plus d’informations sur l’utilisation du paramètre dataProvider, voir la section Utilisation du paramètre dataProvider .

La procédure suivante explique comment ajouter un composant ComboBox à une application pendant la programmation. Le composant ComboBox est modifiable ; si vous tapez Add dans la zone de texte, l’exemple ajoute un élément à la liste déroulante.

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

2. Faites glisser un composant ComboBox sur la scène et nommez l’occurrence aCb . Dans l’onglet Paramètres, définissez le paramètre editable sur true .

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

   import fl.data.DataProvider; 
   import fl.events.ComponentEvent; 
    
   var items:Array = [ 
   {label:"screen1", data:"screenData1"}, 
   {label:"screen2", data:"screenData2"}, 
   {label:"screen3", data:"screenData3"}, 
   {label:"screen4", data:"screenData4"}, 
   {label:"screen5", data:"screenData5"}, 
   ]; 
   aCb.dataProvider = new DataProvider(items); 
        
   aCb.addEventListener(ComponentEvent.ENTER, onAddItem); 
    
   function onAddItem(event:ComponentEvent):void { 
       var newRow:int = 0; 
       if (event.target.text == "Add") { 
           newRow = event.target.length + 1; 
               event.target.addItemAt({label:"screen" + newRow, data:"screenData" + newRow},  
               event.target.length);  
       } 
   }

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