FAQ JavaFXConsultez toutes les FAQ

Pour afficher une fenêtre, il suffit d'invoquer sa méthode show() :

stage.show();

Pour cacher une fenêtre, il suffit d'invoquer sa méthode hide() :

stage.hide();

Vous devez modifier la valeur de la propriété opacity de la classe Stage pour faire varier l’opacité de la fenêtre. La valeur du champ doit être comprise entre 0 (complètement transparent) et 1 (complètement opaque). La modification de valeur sera ignorée sur les systèmes qui ne supportent pas la transparence des fenêtres.

Par exemple :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
public class StageOpacity extends Application { 
  
    @Override 
    public void start(Stage primaryStage) { 
        final Rectangle rectangle = new Rectangle(100, 100, 150, 100); 
        rectangle.setFill(Color.RED); 
        final Pane root = new Pane(); 
        root.getChildren().setAll(rectangle); 
        final Scene scene = new Scene(root, 350, 300); 
        primaryStage.setTitle("Test sur l'opacité de la fenêtre"); 
        primaryStage.setScene(scene);        
        primaryStage.show(); 
        primaryStage.setOpacity(0.5); 
    } 
  
    public static void main(String[] args) { 
        launch(args); 
    } 
}

Le style de la fenêtre peut être modifié en appelant la méthode initStyle() de la classe Stage et en lui passant en paramètre une valeur de type javafx.stage.StageStyle.

1
2
stage.initStyle(StageStyle.UTILITY); 
stage.setVisible(true);

• StageStyle.DECORATED - il s'agit du style par défaut, la fenêtre prend l'apparence d'une fenêtre native du système d'exploitation, la partie cliente au centre de la fenêtre est blanc opaque (lorsque la feuille de style Modena est utilisée, le nœud racine de la scène est gris opaque et cache donc la couleur de la partie cliente de la fenêtre).
  
  
• StageStyle.UNDECORATED - la fenêtre perd toutes ses décorations, mais conserve une couleur de fond blanc opaque
  
  
• StageStyle.TRANSPARENT - la fenêtre perd toutes ses décorations et sa couleur de fond est totalement transparente
  
  
  
  Dans certains cas (Applet, Java Web Start), le gestionnaire de sécurité peut interdire l'usage de ce style ; son support peut donc être testé en invoquant :
  
  

  Code Java :

  Sélectionner tout

  Platform.isSupported(ConditionalFeature.TRANSPARENT_WINDOW);

• StageStyle.UTILITY - une fenêtre secondaire décorée avec des contrôles minimaux. Peut être utilisée pour des boites de dialogue ou des palettes rattachées à une fenêtre principale.
  
  
• StageStyle.UNIFIED - la fenêtre prend l'apparence d'une fenêtre native du système d'exploitation, tout en éliminant l'espace entre la partie cliente et la bordure. La partie cliente au centre de la fenêtre a la même couleur que la bordure de la fenêtre (noir sous Windows 7, 8.x et Mac OS X).
  
  Cette fonctionnalité est optionnelle et son support peut être testé en invoquant :
  
  

  Code Java :

  Sélectionner tout

  Platform.isSupported(ConditionalFeature.UNIFIED_WINDOW);

  
  En cas de non-support, le résultat est identique à une fenêtre utilisant le style StageStyle.DECORATED
  

La couleur de fond d'une scène est blanche (javax.scene.paint.Color.WHITE) par défaut. Vous devez donc la remplacer par la couleur transparente (javax.scene.paint.Color.TRANSPARENT) :

scene.setFill(Color.TRANSPARENT);

root.setBackground(Background.EMPTY);

root.setStyle("-fx-background-color: transparent;");

Pour empêcher une fenêtre d’être fermée, il faut lui passer un callback de type EventHandler<WindowEvent> sur sa propriété onCloseRequest. Dans le corps de ce callback, on prendra soin de consommer l’événement, ce qui l’empêchera de se propager.

1
2
3
4
5
6
stage.setOnCloseRequest(new EventHandler<WindowEvent>() { 
    @Override 
    public void handle(WindowEvent event) { 
        event.consume(); 
    } 
});

stage.setOnCloseRequest(event -> event.consume());

Pour changer l’icône de la fenêtre, vous devez modifier la liste observable icons du stage. Cette liste peut contenir plusieurs versions de la même icône à différentes tailles et résolutions. Le système d'exploitation choisira l'image de la taille appropriée en fonction de ses besoins (icône au coin supérieur gauche de la fenêtre, icône lors du changement de tâche, icône dans la barre des tâches ou le doc, etc.).

Par exemple :

1
2
3
4
5
6
7
stage.getIcons().setAll(new Image(getClass().getResource("appIcon_16.png").toExternalForm()), 
        new Image(getClass().getResource("appIcon_24.png").toExternalForm()), 
        new Image(getClass().getResource("appIcon_32.png").toExternalForm()), 
        new Image(getClass().getResource("appIcon_48.png").toExternalForm()), 
        new Image(getClass().getResource("appIcon_64.png").toExternalForm()), 
        new Image(getClass().getResource("appIcon_128.png").toExternalForm()), 
        new Image(getClass().getResource("appIcon_256.png").toExternalForm()));

Pour passer en affichage plein écran, il faut modifier la propriété fullScreen du Stage et la mettre à la valeur true. Cette propriété est en lecture seule mais dispose d'un setter.

Par exemple :

stage.setFullScreen(true);

Sur JavaFX 8 ou ultérieur, pour changer le message qui s'affiche après le passage en mode plein écran, il suffit de changer la propriété fullScreenExitHint du Stage avant de passer dans ce mode.

Par exemple :

stage.setFullScreenExitHint("");

Sur JavaFX 8 ou ultérieur, pour changer le raccourci clavier qui permet de sortir du mode plein écran, il suffit de changer la propriété fullScreenExitKeyCombination du Stage avant de passer dans ce mode.

Par exemple :

primaryStage.setFullScreenExitKeyCombination(KeyCombination.NO_MATCH);

Le parent d'une fenêtre peut être spécifié en appelant la méthode initOwner() de la classe Stage en lui passant en paramètre une valeur de type javafx.stage.Window.

Par exemple :

dialogWindow.initOwner(primaryStage);

Pour spécifier la modalité d'une fenêtre ou d'une boite de dialogue, il faut invoquer la méthode initModality() de la classe Stage et lui passer en paramètre une valeur de type javafx.stage.Modality.

• Modality.APPLICATION_MODAL - ce mode de modalité bloque la saisie dans les fenêtres de l'application.
• Modality.NONE - aucun blocage de saisie n'est actif.
• Modality.WINDOW_MODAL - toutes les fenêtres dépendantes de la fenêtre parente sont bloquées. N'a aucun effet si un parent n'est pas spécifié.
  

dialogWindow.initModality(Modality.NONE);

Il est possible de récupérer la liste des écrans d'une machine en invoquant la méthode statique getScreens() de la classe javafx.stage.Screen.

Par exemple :

final ObservableList<Screen> screens = Screen.getScreens();

1
2
3
4
5
6
7
8
9
screens.addListener(new ListChangeListener<Screen>() { 
  
    @Override 
    public void onChanged(ListChangeListener.Change<? extends Screen> change) { 
        while (change.next()) { 
            [...] 
        } 
    }             
});

1
2
3
4
5
screens.addListener((ListChangeListener.Change<? extends Screen> change) -> { 
    while (change.next()) { 
        [...] 
    } 
});

Pour savoir quel est l’écran principal de la machine, il suffit d'invoquer la méthode statique getPrimary() de la classe javafx.stage.Screen.

Par exemple :

final Screen screen = Screen.getPrimary();

Pour une zone rectangulaire donnée (région, boite englobante de forme, fenêtre, etc.) on peut récupérer la liste des écrans qui affichent cette zone en invoquant une des variantes de la méthode statique getScreensForRectangle() de la classe javafx.stage.Screen.

Par exemple :

final ObservableList<Screen> screens = Screen.getScreensForRectangle(100, 200, 150, 300);