JList: Le composant liste de choix (1)

Introduction

Le composant javax.swing.JList permet de selectionner un ou plusieurs éléments à partir d'une liste affichée. Ce document vous présente d'abord un résumé de quelques constructeurs et méthodes de la classe JList qui seront utilisés ensuite dans 2 séries d'exemples. La première série montre les possibilités de bases du composant et la seconde montre comment utiliser le ListModel (modèle de liste) associé au JList pour pouvoir agir directements sur les éléments de las liste.

Résumé des constructeurs et méthodes utilisés

Constructeurs

JList( Object[] listData ) Constructeur avec définition de la liste des items dans un tableau d'objets. Si le tableau contient des String, elles sont affichées directement, Si le tableau contient des icônes, se sont ces icônes qui seront affichées dans la liste. Pour les autres types d'objets, la méthode toString() est appelée.
JList( ListModel dataModel ) Le composant affichera les éléments définis dans le ListModel

Méthodes

void setVisibleRowCount( int visibleRowCount ) Permet de définir le nombre de lignes visibles de la liste.
void setSelectionMode( int selectionMode ) Défini si l'on autorise la multi-sélection ou pas
void addListSelectionListener( ListSelectionListener listener ) Ajoute un écouteur sur changement de sélection courante
Object getSelectedValue() Renvoi l'indice du premier item sélectionné (null si pas de sélection)
Object[] getSelectedValues() Renvoi un tableau des items sélectionnés (multi-sélection)
void setSelectedIndex( int index ) Sélection de l'item dont l'indice est spécifié
void setCellRenderer( ListCellRenderer cellRenderer ) Méthode permettant de définir un composant chargé de dessiner chaque cellule de la liste
void setFixedCellHeight( int height ) Fixe la hauteur de chaque item
void setFixedCellWidth( int width ) Fixe la largeur de chaque item

Les exemples

  1. Utilisation basique du JList
  2. Utilisation des ListModels