JList

Qu'est-ce qu'un JList ?

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 .

Déposer un JList

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

Créer une JFrame Form

Créer une Jlist

Paramétrer le Jlist

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

Onglet Code

Type Parameters
le type des objets associés à la liste

Variable Name
le nom de la JList dans le code

Onglet Properties

selectionMode
le mode de sélection offert à l’utilisateur

model
Va définir le texte afficher

Onglet Events

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

Alimenter le JList avec des String

La JList doit être de « Type Parameter » <String>
Créer un attribut DefaultListModel de type <String>

public class MainWindow{
 
    private 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("élément x");

Associer le DefaultListModel à la JList en faisant appel au setModel de la JList

jList1.setmodel(listModel);

Alimenter le JList avec des Objets

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>
Créer un attribut DefaultListModel de type <T>

public class MainWindow{
 
    private 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

// la classe T a ici un 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 dans la JList est textuelle . Elle dépendra donc de la valeur renvoyée par la méthode toString appliquée aux objets de type T

Exploiter la valeur sélectionnée dans la Jlist

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

// getSelectedValue permet de récupérer l'objet sélectionné 
// (libre à chacun d'utiliser des méthodes de l'objet pour 
// obtenir 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()); 
}

Note : dans le cas d'une sélection multiple, la méthode getSelectedValuesList() renvoie la Collection des Objets sélectionnés.