JList est un composant qui ** affiche un ensemble d'éléments ** sous forme de liste et permet à l'utilisateur de ** sélectionner un ou plusieurs ** éléments.

Ces éléments peuvent être de plusieurs natures, selon le besoin :

• Des valeurs de type ** String ** en “dur” ;
• Des valeurs de type String ** dynamiquement ** alimentées par programme ;
• Des valeurs de type ** Object ** appartenant tous à la même classe .

Pour créer une Jlist il faut créer en premier lieu une fenêtre. (** JFrame ** par exemple).

Les ** paramètres essentiels ** à considérer pour personnaliser sa JList (clic droit sur la Jlist > ** Propriété **) sont :

• ** Variable Name ** : le nom de la JList dans le code
• ** Type Parameters ** : le type des objets associés à la liste

• ** selectionMode ** : le mode de sélection offert à l’utilisateur
• ** model ** : Va définir le texte afficher

• ** valueChanged ** : ** événement qui se déclenche ** lorsque la valeur sélectionnée dans la liste change, du fait d’une ** action utilisateur **

• La JList doit être de ** « Type Parameter » <String> ** (étape 2)
• ** Créer ** un attribut ** DefaultListModel de type <String> **

public class MainWindow{
 
    DefaultListModel<String> listModel;
 

• ** Instancier ** le DefaultListModel dans le constructeur

public MainWindow() {
        initComponents();
        listModel = new DefaultListModel();    
    }

• Alimenter le DefaultListModel avec des ** données de type String ** en faisant appel à sa ** méthode addElement **

listModel.addElement("j'ajoute un élément");

• ** Associer le DefaultListModel ** à la JList (variable name étape 2) en faisant appel au ** setModel ** de la JList

jList1.setmodel(listModel);

• Il faut ** disposer d’une classe opérante ** qui représente les objets choisis. Appelons cette ** classe T **
• La JList doit être de ** « Type Parameter » <T> ** (étape 2)
• ** Créer ** un attribut ** DefaultListModel de type <T> **

public class MainWindow{
 
    DefaultListModel<T> listModel;

* ** Instancier ** le DefaultListModel dans le constructeur

public MainWindow() {
        initComponents();
        listModel = new DefaultListModel();    
    }

• Si nécessaire, instancier des objets de la classe T
• ** Alimenter le DefaultListModel ** avec des données de type T en faisant appel à sa méthode ** addElement **

// class T à pour constructeur 2 paramètres (String nom, String prénom)
T t = new T("Le Brun","Titouan");
listModel.addElement(t);

• ** Associer le DefaultListModel ** à la JList (variable name étape 2) en faisant appel au ** setModel ** de la JList

jList1.setmodel(listModel);

La ** présentation des données textuelles ** dépendra de la valeur renvoyée par la ** méthode toString ** appliquée aux objets de type T

Avec une Jlist on a la possibilité de ** récupérer la donnée d'un élément ** lorsqu'un utilisateur clique dessus grâce à la méthode ** getSelectedValue ** .

// getSelectedValue permet de récupérer l'objet dans son ensemble 
// (libre à chacun d'utiliser des méthodes de l'objet pour 
// récupérer des valeurs plus précises)
private void listCategsValueChanged(javax.swing.event.ListSelectionEvent evt) {
     // ici affiche le résultat de la méthode toString appliquée au 
     // type d'objet contenu dans la JList
     System.out.println(jList1.getSelectedValue()); 
}