====== 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 ===

{{ bloc2:prog:poo:jlist_deposer.png?350 |}}

=== Créer une Jlist ===

{{ bloc2:prog:poo:jlist_creer.png?350 |}}

===== 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  | {{ bloc2:prog:poo:jlist_code_propriete.jpg?300 }}  |

=== Onglet Properties ===
|\\ \\ \\ \\ ** selectionMode ** \\ le mode de sélection offert à l’utilisateur \\ \\ \\ **  model ** \\ Va définir le texte afficher  | {{ bloc2:prog:poo:jlist_properties_propriete.png?300 |}} |

=== 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 | {{ bloc2:prog:poo:jlist_event_propriete.jpg?300 |}} |


===== Alimenter le JList avec des String =====

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

<code java>
public class MainWindow{

    private DefaultListModel<String> listModel;
}                
</code>

  * ** Instancier ** le DefaultListModel dans le constructeur


<code java>

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

</code>

  * Alimenter le DefaultListModel avec des ** données de type String ** en faisant appel à sa ** méthode addElement **
<code java>
listModel.addElement("élément x");
</code>

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

<code java>
jList1.setmodel(listModel);
</code>

===== 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> **
<code java>
public class MainWindow{
    private DefaultListModel<T> listModel;
}
</code>

* ** Instancier ** le DefaultListModel dans le constructeur


<code java>

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

</code>

  * 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 **

<code java>
// 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);

</code>

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

<code java>
jList1.setmodel(listModel);
</code>

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 ** (libre au développeur d'utiliser les méthodes de l'objet pour  obtenir ses caractéristiques propres).
<code java>
T t = jList1.getSelectedValue();
System.out.println (t.getNom());  
</code>
Note : dans le cas d'une sélection multiple, la méthode **getSelectedValuesList()** renvoie la Collection des Objets sélectionnés.