Program window display generally has three modes. Non-modal and modal, where modal is divided into program modal and form modal.
Non-modal can be understood as there are no restrictions between forms, and you can use the mouse, keyboard and other tools to switch between forms.
Program modality means that after the form is opened, all the windows of the program are frozen and cannot be switched. They can only be switched after the program modal window is closed.
The form modal means that after the form is opened, all the forms traced back to the form are frozen and cannot be switched. However, if the form is opened in the program, the forms that are not on the traced line can be freely switched with the form.
The test code is as follows:
package javafx8.ch04;
import javafx.application.Application;
import javafx.event.ActionEvent;
import javafx.event.EventHandler;
import javafx.scene.Cursor;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.input.MouseEvent;
import javafx.scene.layout.VBox;
import javafx.stage.Modality;
import javafx.stage.Stage;
import javafx.stage.Window;
import static javafx.stage.Modality.APPLICATION_MODAL;
import static javafx.stage.Modality.NONE;
import static javafx.stage.Modality.WINDOW_MODAL;
/**
* @copyright 2023-2022
* @package learnjavafx8.javafx8.ch04
* @file StageModalityApplication.java
* @date 2023-02-02 20:59
* @author qiao wei
* @version 1.0
* @brief 设置窗体模态，JavaFX共分3中模态。
* 非模态NONE：Defines a top-level window that is not modal and does not block any other window。
* 程序模态APPLICATION_MODAL：Defines a modal window that blocks events from being delivered to any
* other application window。
* 窗体模态WINDOW_MODAL：Defines a modal window that block events from being delivered to its entire
* owner window hierarchy。
* @history
*/
public class StageModalityApplication extends Application {
@Override
public void start(Stage primaryStage) {
// Buttons to display each kind of modal stage
Button ownedNoneButton = new Button("Owned None");
/**
* 父控件为primaryStage，父控件与子控件stage之间为非模态，鼠标可以在父子控件间切换，当父控件关闭时，子控件
* 跟随父控件一起关闭。
*/
ownedNoneButton.addEventHandler(MouseEvent.MOUSE_CLICKED,
new EventHandler<MouseEvent>() {
@Override
public void handle(MouseEvent event) {
showDialog(primaryStage, NONE);
}
}
);
// ownedNoneButton.setOnAction(e -> showDialog(primaryStage, NONE));
// ownedNoneButton.setOnAction(new EventHandler<ActionEvent>() {
// @Override
// public void handle(ActionEvent actionEvent) {
// showDialog(primaryStage, NONE);
// }
// });
Button nonOwnedNoneButton = new Button("Non-owned None");
/**
* 父控件为null， primaryStage与控件stage之间为非模态，鼠标可以在两个控件间切换，当primaryStage控件关闭
* 时，stage控件不关闭。
*/
nonOwnedNoneButton.setOnAction(e -> showDialog(null, NONE));
// 与创建此窗口的上层窗口形成模态。
Button ownedWinButton = new Button("Owned Window Modal");
// 父控件为primaryStage的WINDOW_MODAL模式，只与父控件形成模态，与父控件的其余子控件不形成模态。
ownedWinButton.setOnAction(e -> showDialog(primaryStage, WINDOW_MODAL));
Button nonOwnedWinButton = new Button("Non-owned Window Modal");
// 父控件为null的WINDOW_MODAL模式，因为父控件为null，相当与父控件、父控件的其余子控件不形成模态。
nonOwnedWinButton.setOnAction(e -> showDialog(null, WINDOW_MODAL));
// 与创建此窗口的程序的所有窗口均形成模态。
Button ownedAppButton = new Button("Owned Application Modal");
// Set button opacity。
ownedAppButton.setOpacity(0.3);
// 父控件为primaryStage的APPLICATION_MODAL模式，与Application中的的其余所有子控件均形成模态。
ownedAppButton.setOnAction(e -> showDialog(primaryStage, APPLICATION_MODAL));
Button nonOwnedAppButton = new Button("Non-owned Application Modal");
// 父控件为null的APPLICATION_MODAL模式，与父控件、父控件的其余子控件均形成模态。
nonOwnedAppButton.setOnAction((ActionEvent event)
-> showDialog(null, APPLICATION_MODAL));
VBox root = new VBox();
root.getChildren().addAll(ownedNoneButton,
nonOwnedNoneButton,
ownedWinButton,
nonOwnedWinButton,
ownedAppButton,
nonOwnedAppButton);
Scene scene = new Scene(root, 300, 200);
primaryStage.setScene(scene);
primaryStage.setTitle("The Primary Stage");
// Set full screen and unresizable。
primaryStage.setFullScreen(true);
// primaryStage.setResizable(false);
primaryStage.show();
}
public static void main(String[] args) {
Application.launch(StageModalityApplication.class, args);
}
/**
* @class StageModalityApplication
* @date 2023-06-21 21:01
* @author qiao wei
* @version 1.0
* @brief 根据窗口拥有者和模式设置窗口状态。
* @param owner 窗口的父控件。
* @param modality 窗口模式。
* @return
* @throws
*/
private void showDialog(Window owner, Modality modality) {
// Create a new stage with specified owner and modality
Stage stage = new Stage();
// Set the stage owner and modality
stage.initOwner(owner);
stage.initModality(modality);
Label modalityLabel = new Label(modality.toString());
Button closeButton = new Button("Close");
// closeButton.setOnAction(e -> stage.close());
closeButton.addEventHandler(MouseEvent.MOUSE_CLICKED, mouseEvent -> stage.close());
VBox root = new VBox();
root.getChildren().addAll(modalityLabel, closeButton);
Scene scene = new Scene(root, 200, 100);
// 设置鼠标在scene的显示模式
scene.setCursor(Cursor.HAND);
stage.setScene(scene);
stage.setTitle("A Dialog Box");
stage.show();
}
}