JavaFX _Stage_javafx.stage.Stage表示 JavaFX 桌面应用程序中的窗口。在 JavaFX 内部,Stage您可以插入一个 JavaFX Scene,它表示在窗口内显示的内容 - 在Stage.
当 JavaFX 应用程序启动时,它会创建一个根Stage对象,该对象将传递给 start(Stage primaryStage)JavaFX 应用程序的根类的方法。此Stage 对象代表 JavaFX 应用程序的主窗口。您可以在应用程序生命周期的后期创建新Stage对象,以防应用程序需要打开更多窗口。

创建舞台

您可以像创建任何其他 Java 对象一样创建 JavaFXStage对象:使用new命令和Stage构造函数。下面是创建 JavaFXStage对象的示例。

  1. Stage stage = new Stage();

展示舞台

简单地创建 JavaFXStage对象不会显示它。为了使Stage 可见,您必须调用它的show()或showAndWait()方法。这是显示 JavaFX 的示例Stage:

  1. Stage stage = new Stage();
  2. stage.show();

在舞台上设置场景

为了在 JavaFX 中显示任何内容Stage,您必须Scene 在Stage. 的内容Scene将在显示 Stage时显示在Stage中。Scene 这是在 JavaFX 上设置 a 的示例Stage:

  1. VBox vBox = new VBox(new Label("A JavaFX Label"));
  2. Scene scene = new Scene(vBox);
  3. Stage stage = new Stage();
  4. stage.setScene(scene);

舞台名称

您可以通过该方法 设置 JavaFXStage标题。Stage setTitle()标题Stage显示在Stage窗口的标题栏中。这是设置 JavaFX 标题的示例Stage:

  1. stage.setTitle("JavaFX Stage Window Title");

舞台位置

Stage您可以通过其setX()和setY() 方法 设置 JavaFX 的位置 (X,Y) 。setX()和setY()方法设置由 . 表示的窗口左上角的位置Stage。下面是设置 JavaFXStage对象的 X 和 Y 位置的示例:

  1. Stage stage = new Stage();
  2. stage.setX(50);
  3. stage.setY(50);

Stage请注意,如果设置 X 和 Y 位置, 可能还需要设置宽度和高度,否则舞台窗口可能会变得非常小。有关设置 a 的宽度和高度的更多信息,请参阅下一节Stage。

舞台宽度和高度

Stage您可以通过其setWidth()和setHeight() 方法 设置 JavaFX 的宽度和。这是设置 JavaFX 的宽度和高度的示例Stage:

  1. Stage stage = new Stage();
  2. stage.setWidth(600);
  3. stage.setHeight(300);

舞台风格

Stage您可以通过其initStyle()方法 设置 JavaFX 的样式。您可以选择一组不同的样式:

  • DECORATED
  • UNDECORATED
  • TRANSPARENT
  • UNIFIED
  • UTILITY

装饰Stage是带有操作系统装饰(标题栏和最小化/最大化/关闭按钮)和白色背景的标准窗口。
未装饰Stage是没有操作系统装饰的标准窗口,但仍具有白色背景。
透明Stage是具有透明背景的未装饰窗口。
统一Stage就像一个装饰的舞台,只是装饰区域和主要内容区域之间没有边界。
实用程序Stage是装饰过的窗户,但装饰最少。
这是设置 JavaFX 样式的示例Stage:

  1. stage.initStyle(StageStyle.DECORATED);
  2. //stage.initStyle(StageStyle.UNDECORATED);
  3. //stage.initStyle(StageStyle.TRANSPARENT);
  4. //stage.initStyle(StageStyle.UNIFIED);
  5. //stage.initStyle(StageStyle.UTILITY);

实际上只执行了第一行。其余的被注释掉。他们只是在那里展示如何配置其他选项。

舞台全屏模式

您可以通过该方法 将 JavaFX 切换Stage到全屏模式。Stage setFullScreen()请注意,除非您Scene在Stage. 以下是将 JavaFX Stage 设置为全屏模式的示例:

  1. VBox vbox = new VBox();
  2. Scene scene = new Scene(vbox);
  3. primaryStage.setScene(scene);
  4. primaryStage.setFullScreen(true);
  5. primaryStage.show();

阶段生命周期事件

JavaFX Stage 可以发出一些您可以监听的事件。这些舞台活动是:

  1. Close Request
  2. Hiding
  3. Hidden
  4. Showing
  5. Shown

关闭阶段事件监听器

您可以在 JavaFX 舞台上侦听关闭事件,这意味着当用户单击舞台窗口右上角的 X 按钮时,您会收到通知。如果您需要在主 Stage 窗口关闭后清理一些资源,或者例如需要停止一些线程等,监听 Stage 关闭事件会很有用。下面是一个监听 Stage 关闭事件的示例:

  1. primaryStage.setOnCloseRequest((event) -> {
  2. System.out.println("Closing Stage");
  3. });

舞台键盘事件

可以在 JavaFX Stage 上侦听键盘事件。这样,您可以捕获在舞台具有焦点时发生的所有键盘事件。这是一个侦听键盘上的 ESC 和 Return 键的示例 - 当 JavaFX Stage 具有焦点时:

  1. primaryStage.addEventHandler(KeyEvent.KEY_PRESSED, (event) -> {
  2. System.out.println("Key pressed: " + event.toString());
  3. switch(event.getCode().getCode()) {
  4. case 27 : { // 27 = ESC key
  5. primaryStage.close();
  6. break;
  7. }
  8. case 10 : { // 10 = Return
  9. primaryStage.setWidth( primaryStage.getWidth() * 2);
  10. }
  11. default: {
  12. System.out.println("Unrecognized key");
  13. }
  14. }
  15. });
  16. stage.addEventHandler(KeyEvent.KEY_TYPED,e->{
  17. System.out.println(e.getCharacter());
  18. });