JavaFX问题：BorderPane在最大化Stage中初始未居中

问题现象 #

使用Java 17 + JavaFX 17开发桌面游戏，采用BorderPane布局：中心区域放置游戏棋盘（普通Pane），顶部、底部区域放置操作选项与附加信息。设置stage.setMaximized(true)后，程序启动切换到游戏界面时，BorderPane未在Stage中居中，反而向右下方延伸超出可视区域，导致底部节点无法显示。但将窗口最小化后再次最大化，所有元素即可正确适配Stage边界。

当前CSS仅设置背景颜色，无其他布局相关样式。

核心场景代码 #

@Override
public void start(Stage stage) throws Exception {
    this.stage = stage;

    Pane pane = createGameBoard();
    pane.setId("mapPane");

    Button button = new Button("Save");

    VBox box = new VBox(0, button);
    box.setAlignment(Pos.CENTER);

    Label label = new Label("Bottom");
    label.setPrefHeight(20);

    BorderPane borderPane = new BorderPane();
    borderPane.setTop(top);
    borderPane.setBottom(bottom);
    borderPane.setCenter(center);
    borderPane.setPadding(new Insets(10));

    Scene scene = new Scene(borderPane);
    
    scene.getStylesheets().add(Objects.requireNonNull(MainGUI.class.getResource("/game.css")).toString());

    stage.setScene(scene);
}

可复现完整代码 #

import javafx.application.Application;
import javafx.geometry.Insets;
import javafx.geometry.Pos;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.layout.BorderPane;
import javafx.scene.layout.Pane;
import javafx.scene.layout.VBox;
import javafx.scene.shape.Circle;
import javafx.stage.Stage;

public class App extends Application {

    private Stage stage;

    public static void main(String[] args) {
        launch(args);
    }

    @Override
    public void start(Stage stage) throws Exception {
        this.stage = stage;
        stage.setTitle("App");
        stage.setMinHeight(600);
        stage.setMinWidth(800);
        stage.setWidth(java.awt.Toolkit.getDefaultToolkit().getScreenSize().getWidth());
        stage.setHeight(java.awt.Toolkit.getDefaultToolkit().getScreenSize().getHeight());
        stage.setMaximized(true);
        stage.setOnCloseRequest(e -> System.exit(0));

        Button button = new Button("Next Screen");
        button.setOnAction(e -> {gameScreen();});

        BorderPane borderPane = new BorderPane();
        borderPane.setCenter(button);
        
        Scene scene = new Scene(borderPane);

        stage.setScene(scene);

        stage.show();
    }

    private void gameScreen() {
        Circle circle = new Circle(0, 0, 4);
        Pane pane = new Pane(circle);
        pane.setStyle("-fx-background-color: #00c3ff");

        Button button = new Button("Top");
        VBox vBox = new VBox(0, button);
        vBox.setAlignment(Pos.CENTER);

        Label label = new Label("Bottom");

        BorderPane borderPane = new BorderPane();
        borderPane.setTop(vBox);
        borderPane.setCenter(pane);
        borderPane.setBottom(label);
        borderPane.setPadding(new Insets(10));

        Scene scene = new Scene(borderPane);

        stage.setScene(scene);
    }

}

解决方案 #

该问题是JavaFX在最大化状态下切换场景时，布局计算未正确触发导致的，可通过以下几种方式解决：

方法1：切换场景后手动触发布局刷新 #

在设置新Scene后，调用stage.sizeToScene()强制触发布局适配：

private void gameScreen() {
    // 原代码保持不变
    Scene scene = new Scene(borderPane);
    stage.setScene(scene);
    // 添加该行代码
    stage.sizeToScene();
}

方法2：移除手动设置的Stage尺寸，仅保留最大化配置 #

原代码中同时设置stage.setWidth()、stage.setHeight()与stage.setMaximized(true)会干扰JavaFX的最大化布局逻辑，移除手动设置宽高的代码即可：

@Override
public void start(Stage stage) throws Exception {
    this.stage = stage;
    stage.setTitle("App");
    stage.setMinHeight(600);
    stage.setMinWidth(800);
    // 移除下面两行手动设置尺寸的代码
    // stage.setWidth(java.awt.Toolkit.getDefaultToolkit().getScreenSize().getWidth());
    // stage.setHeight(java.awt.Toolkit.getDefaultToolkit().getScreenSize().getHeight());
    stage.setMaximized(true);
    stage.setOnCloseRequest(e -> System.exit(0));
    // 原代码保持不变
}

方法3：给中心Pane添加尺寸约束 #

普通Pane默认无尺寸约束，在BorderPane中可能导致布局异常，可设置其最大宽高为无限大，使其自动适配父容器：

Pane pane = new Pane(circle);
pane.setStyle("-fx-background-color: #00c3ff");
// 添加尺寸约束
pane.setMaxWidth(Double.MAX_VALUE);
pane.setMaxHeight(Double.MAX_VALUE);

内容的提问来源于stack exchange，提问作者Phylonias