Sélection dans la palette

Coté design

Pour définir les entrées d'une combo box à la main, utilisez la propriété model. En cliquant sur les ... à droite de la propriété vous ouvrez un éditeur qui vous permet de saisir les intitulés des différents choix.

Gestionnaire d'évènement

Le fait de sélectionner une entrée dans une combo box génère un évènement de type ActionPerformed. Pour définir un gestionnaire pour cet évènement, faites un double clic sur la combo box. Le nom de la procédure évènementielle générée par NetBeans est composé du nom de la combo box suivi de ActionPerformed.

Méthodes utiles

• addItem (Object o): ajoute l'objet o à la combo box. Dans la pratique, l'objet sera le plus souvent une chaine de caractères.
• getItemAt (int i): retourne l'entrée de la combo box qui se trouve en position i, sachant que la position 0 correspond à la première entrée. Le résultat retourné est de type Object. Pour le convertir en chaine de caractères, il faudra donc lui appliquer la méthode toString.
• getItemCount (): retourne le nombre d'entrées de la combo box. Le résultat retourné est de type int.
• getSelectedIndex (): retourne la position de l'entrée sélectionnée par l'utilisateur. Si aucune entrée n'est sélectionnée, le résultat est -1. Le résultat retourné est de type int.
• getSelectedItem (): retourne l'entrée de la combo box sélectionnée par l'utilisateur. Le résultat retourné est de type Object. Pour le convertir en chaine de caractères, il faudra donc lui appliquer la méthode toString.
• removeAllItems (): supprime toutes les entrées de la combo box.
• removeItemAt (int i): supprime l'entrée se trouvant en position i.
• setSelectedIndex (int i): présélectionne l'entrée de position i. Si i = -1, aucune entrée n'est sélectionnée.

Attention: toutes les méthodes modifiant l'état de la combo box, génèrent un évènement de type ActionPerformed! Dans les exercices, nous verrons comment contourner ce problème.

Exemple

L'exemple présenté ici se trouve dans le dossier Exemple-Swing/ComboBox. Il s'agit d'une application permettant de sélectionner des produits dans un magasin de bricolage.

Dans cet exemple, nous ne verrons quelques unes des méthodes précédentes. Par contre, elles seront toutes utilisées dans l'exercice portant sur la réalisation d'un dictionnaire illustré.

Fenêtre du projet

La fenêtre comprend deux combo box nommées CB_Categorie et CB_Produit, un bouton et un champ de texte nommé CT_Produit.

Extraits de code

Lorsque l'utilisateur sélectionne une entrée de la combo box "Catégories", tous les produits de cette catégories sont affichés dans la combo box produit. Voici la procédure évènementielle correspondante:

private void CB_CategorieActionPerformed(...) {                                             
   
   int Categorie = CB_Categorie.getSelectedIndex();
    
    CB_Produit.removeAllItems();
     
     switch (Categorie)
     {
       case 0: // Electricité    
        CB_Produit.addItem("Ampoule");
        CB_Produit.addItem("Cable");
        .
        .
        break;
       case 1: // Jardinage
        CB_Produit.addItem("Pelle");
        CB_Produit.addItem("Rateau");
        .
        .
        break;
        .
        .

On récupère tout d'abord la position de la catégorie sélectionnée à l'aide de getSelectedIndex. Le contenu de la combo box est ensuite vidé à l'aide de removeAllItems. Puis les produits de la catégorie correspondante sont ajoutés à la combo box avec la méthode addItem.

Lorsque l'utilisateur clique sur le bouton "Commander", le produit sélectionné s'affiche dans le champ de texte. Cette action est exécutée par la procédure évènementielle suivante:

private void BT_CommanderActionPerformed(...) {                                             
      String Produit = CB_Produit.getSelectedItem().toString();
      CT_Produit.setText(Produit); 
}  

Le produit sélectionné est récupéré via la méthode getSelectedItem. Comme elle retourne une référence à un objet (représentant l'entrée sélectionnée), il est nécessaire de convertir cette référence en une référence à une chaine de caractères avec toString.