FAQ JavaFXConsultez toutes les FAQ

Pour ajouter des valeurs dans une TableView, il suffit de les ajouter dans sa liste observable items.

Par exemple :

1
2
final TableView<Car> tableView = new TableView(); 
tableView .getItems().setAll(car1, car2, car3, car4);

Pour savoir quand une valeur est s�lectionn�e dans une TableView, il faut r�cup�rer le mod�le de s�lection dans la table en invoquant sa m�thode getSelectionModel() et �couter les changements de valeur de sa propri�t� selectedIndex ou selectedItem avec �couteur de type InvalidationListener ou un ChangeListener.

Par exemple :

1
2
tableView.getSelectionModel().selectedIndexProperty().addListener(observable -> System.out.printf("Indice s�lectionn�: %d", tableView.getSelectionModel().getSelectedIndex()).println()); 
tableView.getSelectionModel().selectedItemProperty().addListener(observable -> System.out.printf("Valeur s�lectionn�e: %d", tableView.getSelectionModel().getSelectedItem()).println());

Pour s�lectionner une valeur dans une TableView, il faut r�cup�rer le mod�le de s�lection de la table graphique en invoquant sa m�thode getSelectionModel(). On peut ensuite invoquer une des variantes de la m�thode select() pour s�lectionner un indice ou une valeur donn�e.

Par exemple :

tableView.getSelectionModel().select(car1);

Pour faire que les colonnes occupent tout l'espace horizontal de la TableView, il faut modifier la valeur de la propri�t� columnResizePolicy de la table graphique. Cette propri�t� accepte un callback qui permet d'effectuer la mise en page des colonnes. Cependant, de base, deux impl�mentations sont fournies pr�tes � l'emploi dans la classe TableView :

• TableView.UNCONSTRAINED_RESIZE_POLICY - la valeur par d�faut : la mise en page des colonnes d�pend de leur largeur pr�f�r�e ;
• TableView.CONSTRAINED_RESIZE_POLICY - les colonnes sont redimensionn�es pour occuper toute la largeur de la table.
  

tableView.setColumnResizePolicy(TableView.CONSTRAINED_RESIZE_POLICY);

Pour d�sactiver le tri automatique sur les colonnes qui se d�clenche lors que l'utilisateur clique sur l�ent�te d'une colonne avec la souris, il faut modifier la propri�t� sortable de cette colonne et lui donner une valeur false.

Par exemple :

colorColumn.setSortable(false);

Initialement, une TableView ne contient aucune colonne. Pour ajouter des colonnes dans une table, il faut cr�er des objets de type javafx.scene.control.TableColumn<S, T> et les ajouter dans la liste observable columns de la table.

Ici :

• S est le type des objets contenus dans l'instance de TableView ;
• T est le type des objets qui seront affich�s ou �dit�s dans la colonne.
  

1
2
final TableColumn<Car, String> modelColumn = new TableColumn<>("Mod�le"); 
tableView.getColumns().setAll(modelColumn);

1
2
3
4
5
final TableColumn<Car, String> brandColumn = new TableColumn<>("Marque"); 
final TableColumn<Car, Color> colorColumn = new TableColumn<>("Couleur"); 
final TableColumn<Car, Integer> seatsColumn = new TableColumn<>("Si�ges"); 
final TableColumn<Car, Integer> doorsColumn = new TableColumn<>("Portes"); 
tableView.getColumns().addAll(brandColumn, colorColumn, seatsColumn, doorsColumn);

Pour faire des sous-colonnes, il suffit d'ajouter des colonnes dans la liste observable columns d'une autre colonne.

Par exemple :

1
2
3
4
5
6
7
8
final TableColumn<Car, String> modelColumn = new TableColumn<>("Mod�le"); 
final TableColumn<Car, String> brandColumn = new TableColumn<>("Marque"); 
final TableColumn<Car, Color> colorColumn = new TableColumn<>("Couleur"); 
final TableColumn<Car, Integer> seatsColumn = new TableColumn<>("Si�ges"); 
final TableColumn<Car, Integer> doorsColumn = new TableColumn<>("Portes"); 
final TableColumn<Car, ?> optionsColumn = new TableColumn<>("Options"); 
optionsColumn.getColumns().setAll(colorColumn, seatsColumn, doorsColumn); 
tableView.getColumns().setAll(modelColumn, brandColumn, optionsColumn);

Une fabrique � valeurs (value factory en anglais) est un callback plac� sur une colonne de type <S, T> et qui permet de retrouver une valeur de type T � partir d'un objet source de type S contenu dans la table.

Les objets de type TableColumn<S, T> disposent d'une propri�t� cellValueFactory qui permet de sp�cifier ce callback (� ne pas confondre avec la propri�t� cellFactory).

Par exemple :

• si l'objet est accessible par une propri�t� JavaFX, c'est tr�s simple, nous pouvons cr�er une nouvelle instance de la classe javafx.scene.control.cell.PropertyValueFactory<S, T> qui se chargera pour nous d�acc�der � la propri�t� :
  

  Code Java :

  S�lectionner tout

  modelColumn.setCellValueFactory(new PropertyValueFactory<>("model"));

  
  Si la cellule est �ditable et que son contenu est modifi�, la propri�t� JavaFX de l'objet source sera directement mise � jour ;
• si l'objet est accessible par une propri�t� Java Beans observable, nous pouvons l'empaqueter comme d'habitude gr�ce � un monteur pr�d�fini disponible dans le package javafx.beans.property.adapter :
  
  

  Code Java :

  S�lectionner tout

  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  modelColumn.setCellValueFactory(new Callback<TableColumn.CellDataFeatures<Car, String>, ObservableValue<String>>() { 
    
      @Override 
      public ObservableValue<String> call(TableColumn.CellDataFeatures<Car, String> param) { 
          final Car car = param.getValue();  
          try { 
              return JavaBeanStringPropertyBuilder.create().bean(car).name("model").build(); 
          } catch (NoSuchMethodException ex) { 
              Logger.getLogger(getClass().getName()).log(Level.SEVERE, ex.getMessage(), ex); 
              return null; 
          } 
      } 
  });

  
  Ou :
  
  

  Code Java :

  S�lectionner tout

  1
  2
  3
  4
  5
  6
  7
  8
  9
  modelColumn.setCellValueFactory(param  -> { 
      final Car car = param.getValue(); 
      try { 
          return JavaBeanStringPropertyBuilder.create().bean(car).name("model").build(); 
      } catch (NoSuchMethodException ex) { 
          Logger.getLogger(getClass().getName()).log(Level.SEVERE, ex.getMessage(), ex); 
          return null; 
      } 
  });

  
  
  Si la cellule est �ditable et que son contenu est modifi�, la propri�t� Java Beans observable de l'objet source sera directement mise � jour ;
• Si l'objet n'est pas accessible par une propri�t� JavaFX ou une propri�t� Java Beans observable, nous allons devoir instancier manuellement une valeur observable pour stocker l'objet retourn� :
  

  Code Java :

  S�lectionner tout

  1
  2
  3
  4
  5
  6
  7
  8
  modelColumn.setCellValueFactory(new Callback<TableColumn.CellDataFeatures<Car, String>, ObservableValue<String>>() { 
    
      @Override 
      public ObservableValue<String> call(TableColumn.CellDataFeatures<Car, String> param) { 
          final Car car = param.getValue(); 
          return new SimpleStringProperty(car.getModel()); 
      } 
  });

  
  Ou :
  
  

  Code Java :

  S�lectionner tout

  1
  2
  3
  4
  modelColumn.setCellValueFactory(param  -> { 
      final Car car = param.getValue(); 
      return new SimpleStringProperty(car.getModel()); 
  });

  
  
  Ici, il n'y a aucune liaison entre la propri�t� retourn�e et l'objet source, donc en cas d��dition les modifications ne sont pas report�es sur l'objet source.
  

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
final TableView<Car> tableView = new TableView();  
tableView .getItems().setAll(car1, car2, car3, car4, car5); 
final TableColumn<Car, String> modelColumn = new TableColumn<>("Mod�le"); 
modelColumn.setCellValueFactory(param -> { 
    final Car car = param.getValue(); 
    return new SimpleStringProperty(car.getModel()); 
}); 
final TableColumn<Car, String> brandColumn = new TableColumn<>("Marque"); 
brandColumn.setCellValueFactory(param -> { 
    final Car car = param.getValue(); 
    return new SimpleStringProperty(car.getBrand()); 
}); 
final TableColumn<Car, Color> colorColumn = new TableColumn<>("Couleur"); 
colorColumn.setCellValueFactory(param -> { 
    final Car car = param.getValue(); 
    return new SimpleObjectProperty<>(car.getColor()); 
}); 
final TableColumn<Car, Integer> seatsColumn = new TableColumn<>("Si�ges"); 
seatsColumn.setCellValueFactory(param -> { 
    final Car car = param.getValue(); 
    return new SimpleObjectProperty<>(car.getSeats()); 
}); 
final TableColumn<Car, Integer> doorsColumn = new TableColumn<>("Portes"); 
doorsColumn.setCellValueFactory(param -> { 
    final Car car = param.getValue(); 
    return new SimpleObjectProperty<>(car.getDoors()); 
}); 
final TableColumn<Car, ?> optionsColumn = new TableColumn<>("Options"); 
optionsColumn.getColumns().setAll(colorColumn, seatsColumn, doorsColumn); 
tableView.getColumns().setAll(modelColumn, brandColumn, optionsColumn); 
tableView.setColumnResizePolicy(TableView.CONSTRAINED_RESIZE_POLICY);

Ici, chaque colonne de la table dispose de sa propre propri�t� cellFactory qui permet de placer un callback permettant de g�n�rer des cellules pour chaque ligne de cette colonne.

Prenons, par exemple, la couleur de la carrosserie de notre voiture. Nous allons utiliser une cellule qui affiche un rectangle de couleur (en fait une Region) :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
public class CarColorTableCell extends TableCell<Car, Color> { 
  
    final Region region = new Region(); 
  
    @Override 
    protected void updateItem(Color item, boolean empty) { 
        super.updateItem(item, empty); 
        setGraphic(null);   
        setText(null);   
        if (!empty && item != null) { 
            region.setBackground(new Background(new BackgroundFill(item, CornerRadii.EMPTY, Insets.EMPTY))); 
            setGraphic(region);             
            setContentDisplay(ContentDisplay.GRAPHIC_ONLY); 
        } 
    }     
}

1
2
3
4
5
6
7
colorColumn.setCellFactory(new Callback<TableColumn<Car, Color>, TableCell<Car, Color>>() { 
  
    @Override 
    public TableCell<Car, Color> call(TableColumn<Car, Color> tc) { 
        return new CarColorTableCell(); 
    } 
});

colorColumn.setCellFactory(tc -> new CarColorTableCell());

Il est possible d'activer l��dition sur une TableView en modifiant la valeur de sa propri�t� editable et en lui donnant la valeur true. De plus, chaque colonne dispose de sa propre propri�t� editable, ce qui permet d�activer ou de d�sactiver l��dition sur cette colonne.

Par exemple :

1
2
tableView.setEditable(true); 
ageColumn.setEditable(false);

ageColumn.setEditable(true);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
lastNameNameColumn.setCellFactory(TextFieldTableCell.forTableColumn()); 
firstNameColumn.setCellFactory(TextFieldTableCell.forTableColumn()); 
ageColumn.setCellFactory(TextFieldTableCell.forTableColumn(new StringConverter<Integer>() { 
  
    @Override 
    public String toString(Integer object) { 
        return String.valueOf(object); 
    } 
  
    @Override 
    public Integer fromString(String string) { 
        return Integer.parseInt(string); 
    } 
}));

Pour afficher des cases � cocher dans les colonnes contenant des valeurs bool�ennes, il faut utiliser des cellules pr�tes � l'emploi de type javafx.scene.control.cell.CheckBoxTableCell. Vous pouvez soit directement �tendre cette classe, soit utiliser une des m�thodes statiques de fabrique disponibles.

Par exemple :

booleanColumn.setCellFactory(CheckBoxTableCell.forTableColumn(booleanColumn));

• si la valeur de la propri�t� change, l��tat selected de la case � cocher sera mis � jour en cons�quence ;
• si la table est �ditable, s�lectionner ou d�s�lectionner la case mettra � jour la valeur de la propri�t�.
  

Pour afficher des boites d�roulantes dans une TableView, il faut utiliser des cellules pr�tes � l'emploi de type javafx.scene.control.cell.ChoiceBoxTableCell ou de type javafx.scene.control.cell.ComboBoxTableCell. Vous pouvez soit directement �tendre ces classes, soit utiliser une des m�thodes statiques de fabrique disponibles.

Par exemple :

sexColumn.setCellFactory(ChoiceBoxTableCell.forTableColumn(Person.Sex.values()));

sexColumn.setCellFactory(ComboBoxTableCell.forTableColumn(Person.Sex.values()));