FAQ JavaFXConsultez toutes les FAQ

Pour créer une barre de menu, il vous faut créer une instance de la classe javafx.scene.control.MenuBar, et placer cette instance dans votre IU, par exemple dans la partie top d'un BorderPane.

Par exemple :

1
2
3
final MenuBar menuBar = new MenuBar(); 
final BorderPane root = new BorderPane(); 
root.setTop(menuBar);

Sur Mac OS X, le plus souvent, la barre de menu d'une application n'est pas affichée en haut de la fenêtre de l'application ; elle apparait plutôt dans la barre de menu système, en haut de l’écran. Le contenu de la barre de menu système change en fonction de la fenêtre active.

Pour activer cette fonctionnalité, il vous suffit de modifier la valeur de la propriété useSystemMenuBar de la classe MenuBar et de lui donner une valeur égale à true.

Par exemple :

menuBar.setUseSystemMenuBar(true);

Pour ajouter des entrées dans une barre de menu, il faut ajouter des instances de la classe javafx.scene.control.Menu dans la liste observable menus de cette barre.

Par exemple :

1
2
3
4
5
final Menu fileMenu = new Menu("Fichier"); 
final Menu editMenu = new Menu("Édition"); 
final Menu helpMenu = new Menu("Aide"); 
final MenuBar menuBar = new MenuBar(); 
menuBar.getMenus().setAll(fileMenu, editMenu, helpMenu);

Pour ajouter des entrées dans des menus, il faut ajouter des instances de la classe javafx.scene.control.MenuItem dans la liste observable items du menu.

Ces instances peuvent être des types suivants :

• Menu - un sous-menu ;
• MenuItem - une entrée simple ;
• CheckMenuItem - une entrée à cocher ;
• RadioMenuItem - une entrée radio à cocher ; ce type d’entrée est également une bascule ;
• SeparatorMenuItem - un séparateur horizontal ;
• CustomMenuItem - une entrée contenant un menu à l'apparence customisée.
  

1
2
3
4
5
6
7
8
9
10
11
12
final MenuItem exitItem = new MenuItem("Quitter"); 
final Menu fileMenu = new Menu("Fichier"); 
fileMenu.getItems().setAll(exitItem); 
final MenuItem copyItem = new MenuItem("Copier"); 
final MenuItem cutItem = new MenuItem("Couper"); 
final MenuItem pasteItem = new MenuItem("Coller"); 
final MenuItem optionsItem= new MenuItem("Options...");  
final Menu editMenu = new Menu("Édition"); 
editMenu.getItems().setAll(copyItem, cutItem, pasteItem, new SeparatorMenuItem(), optionsItem); 
final MenuItem aboutItem = new MenuItem("À propos..."); 
final Menu helpMenu = new Menu("Aide"); 
helpMenu.getItems().setAll(aboutItem);

Pour créer un menu contextuel, il vous faut créer une instance de la classe javafx.scene.control.ContextMenu. Pour ajouter des entrées dans ce menu, il faut ajouter des instances de la classe javafx.scene.control.MenuItem dans la liste observable items du menu contextuel.

Par exemple :

1
2
3
4
5
6
7
final MenuItem imageItem = new MenuItem("Image..."); 
final MenuItem pdfItem = new MenuItem("PDF..."); 
final Menu exportMenu = new Menu("Export"); 
exportMenu.getItems().setAll(imageItem, pdfItem); 
final MenuItem propertiesItem = new MenuItem("Propriétés..."); 
final ContextMenu contextMenu = new ContextMenu(); 
contextMenu.getItems().setAll(exportMenu, new SeparatorMenuItem(), propertiesItem);

Les nœuds graphiques qui héritent de la classe Control disposent de la propriété contextMenu qui permet de placer un menu contextuel sur eux. Si cette propriété n'a pas une valeur égale à null, le menu contextuel sera invoqué lorsque l'utilisateur effectue une action qui affiche d'ordinaire un menu contextuel (par exemple : clic droit avec la souris).

Par exemple :

myControl.setContextMenu(contextMenu);

1
2
3
4
5
6
rectangle.addEventHandler(ContextMenuEvent.CONTEXT_MENU_REQUESTED, new EventHandler<ContextMenuEvent>() { 
    public void handle(ContextMenuEvent contextMenuEvent) { 
        contextMenu.show(rectangle, contextMenuEvent.getScreenX(), contextMenuEvent.getScreenY()); 
        contextMenuEvent.consume(); 
    } 
});

1
2
3
4
rectangle.addEventHandler(ContextMenuEvent.CONTEXT_MENU_REQUESTED, contextMenuEvent -> { 
    contextMenu.show(rectangle, contextMenuEvent.getScreenX(), contextMenuEvent.getScreenY()); 
    contextMenuEvent.consume(); 
});

Pour réagir à l'activation d'une entrée dans un menu, il suffit de placer un callback de type EventHandler<ActionEvent> dans sa propriété onAction.

Par exemple :

1
2
3
4
5
6
7
item.setOnAction(new EventHandler<ActionEvent>() { 
  
    @Override 
    public void handle(ActionEvent actionEvent) { 
        System.out.println("Salut le monde !"); 
    } 
});

item.setOnAction(actionEvent ->  System.out.println("Salut le monde !"));

Pour mettre une icône sur une entrée, il suffit de modifier la valeur de sa propriété graphic et de lui donner comme nouvelle valeur une ImageView contenant une Image.

1
2
3
final Image image = new Image(getClass().getRessource("Ok.png").toExternalForm()); 
final ImageView icon = new ImageView(image); 
item.setGraphic(icon);

Pour créer une entrée customisée dans un menu, il faut créer une instance de la classe javafx.scene.control.CustomMenuItem et lui fournir un contrôle destiné à être affiché dans cette entrée en modifiant la valeur de sa propriété content.

Par défaut, les entrées de menu sont configurées pour cacher le menu dès qu'on les active à la souris. La classe CustomMenuItem dispose de la propriété hideOnClick qui permet de désactiver ce comportement.

Par exemple :

1
2
final CustomMenuItem customMenuItem = new CustomMenuItem(new Slider()); 
customMenuItem.setHideOnClick(false);