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对象的示例。
Stage stage = new Stage();
展示舞台
简单地创建 JavaFXStage对象不会显示它。为了使Stage 可见,您必须调用它的show()或showAndWait()方法。这是显示 JavaFX 的示例Stage:
Stage stage = new Stage();
stage.show();
在舞台上设置场景
为了在 JavaFX 中显示任何内容Stage,您必须Scene 在Stage. 的内容Scene将在显示 Stage时显示在Stage中。Scene 这是在 JavaFX 上设置 a 的示例Stage:
VBox vBox = new VBox(new Label("A JavaFX Label"));
Scene scene = new Scene(vBox);
Stage stage = new Stage();
stage.setScene(scene);
舞台名称
您可以通过该方法 设置 JavaFXStage标题。Stage setTitle()标题Stage显示在Stage窗口的标题栏中。这是设置 JavaFX 标题的示例Stage:
stage.setTitle("JavaFX Stage Window Title");
舞台位置
Stage您可以通过其setX()和setY() 方法 设置 JavaFX 的位置 (X,Y) 。setX()和setY()方法设置由 . 表示的窗口左上角的位置Stage。下面是设置 JavaFXStage对象的 X 和 Y 位置的示例:
Stage stage = new Stage();
stage.setX(50);
stage.setY(50);
Stage请注意,如果设置 X 和 Y 位置, 可能还需要设置宽度和高度,否则舞台窗口可能会变得非常小。有关设置 a 的宽度和高度的更多信息,请参阅下一节Stage。
舞台宽度和高度
Stage您可以通过其setWidth()和setHeight() 方法 设置 JavaFX 的宽度和。这是设置 JavaFX 的宽度和高度的示例Stage:
Stage stage = new Stage();
stage.setWidth(600);
stage.setHeight(300);
舞台风格
Stage您可以通过其initStyle()方法 设置 JavaFX 的样式。您可以选择一组不同的样式:
- DECORATED
- UNDECORATED
- TRANSPARENT
- UNIFIED
- UTILITY
装饰Stage是带有操作系统装饰(标题栏和最小化/最大化/关闭按钮)和白色背景的标准窗口。
未装饰Stage是没有操作系统装饰的标准窗口,但仍具有白色背景。
透明Stage是具有透明背景的未装饰窗口。
统一Stage就像一个装饰的舞台,只是装饰区域和主要内容区域之间没有边界。
实用程序Stage是装饰过的窗户,但装饰最少。
这是设置 JavaFX 样式的示例Stage:
stage.initStyle(StageStyle.DECORATED);
//stage.initStyle(StageStyle.UNDECORATED);
//stage.initStyle(StageStyle.TRANSPARENT);
//stage.initStyle(StageStyle.UNIFIED);
//stage.initStyle(StageStyle.UTILITY);
实际上只执行了第一行。其余的被注释掉。他们只是在那里展示如何配置其他选项。
舞台全屏模式
您可以通过该方法 将 JavaFX 切换Stage到全屏模式。Stage setFullScreen()请注意,除非您Scene在Stage. 以下是将 JavaFX Stage 设置为全屏模式的示例:
VBox vbox = new VBox();
Scene scene = new Scene(vbox);
primaryStage.setScene(scene);
primaryStage.setFullScreen(true);
primaryStage.show();
阶段生命周期事件
JavaFX Stage 可以发出一些您可以监听的事件。这些舞台活动是:
Close Request
Hiding
Hidden
Showing
Shown
关闭阶段事件监听器
您可以在 JavaFX 舞台上侦听关闭事件,这意味着当用户单击舞台窗口右上角的 X 按钮时,您会收到通知。如果您需要在主 Stage 窗口关闭后清理一些资源,或者例如需要停止一些线程等,监听 Stage 关闭事件会很有用。下面是一个监听 Stage 关闭事件的示例:
primaryStage.setOnCloseRequest((event) -> {
System.out.println("Closing Stage");
});
舞台键盘事件
可以在 JavaFX Stage 上侦听键盘事件。这样,您可以捕获在舞台具有焦点时发生的所有键盘事件。这是一个侦听键盘上的 ESC 和 Return 键的示例 - 当 JavaFX Stage 具有焦点时:
primaryStage.addEventHandler(KeyEvent.KEY_PRESSED, (event) -> {
System.out.println("Key pressed: " + event.toString());
switch(event.getCode().getCode()) {
case 27 : { // 27 = ESC key
primaryStage.close();
break;
}
case 10 : { // 10 = Return
primaryStage.setWidth( primaryStage.getWidth() * 2);
}
default: {
System.out.println("Unrecognized key");
}
}
});
stage.addEventHandler(KeyEvent.KEY_TYPED,e->{
System.out.println(e.getCharacter());
});