JavaFX Dialog窗口setY()方法设置Y轴坐标不生效问题咨询

问题现象 #

在Ubuntu 20操作系统、JavaFX 19-ea+3、OpenJDK 14.0.2环境下运行代码，显式设置Dialog窗口X坐标为660、Y坐标为300，固定窗口宽600、高450，实际运行时X坐标符合设置值，Y轴坐标位置与预期不符。

复现代码 #

public class JavaFxTest4 extends Application {
    public static void main(String[] args) {
        launch(args);
    }

    @Override
    public void start(Stage primaryStage) {
        Button button = new Button();
        button.setText("dialog");
        button.setOnAction((e) -> {
            Dialog<?> d = new Dialog<>();
            final Window window = d.getDialogPane().getScene().getWindow();
            Stage stage = (Stage) window;
            stage.setMinHeight(450);
            stage.setMaxHeight(450);
            stage.setHeight(450);
            stage.setMinWidth(600);
            stage.setMaxWidth(600);
            stage.setWidth(600);
            window.setY(300); //<---- note this line
            window.setX(660); //<---- note this line
            d.showAndWait();
        });

        VBox root = new VBox();
        root.getChildren().addAll(button);
        var scene = new Scene(root, 1920, 1000);
        primaryStage.setScene(scene);
        primaryStage.show();
    }
}

问题原因 #

• 坐标设置时机错误：调用showAndWait()前，Dialog对应的原生窗口还未完成初始化，系统窗口管理器尚未把窗口标题栏、边框的实际尺寸同步给JavaFX。Ubuntu默认GNOME桌面的窗口装饰仅顶部存在标题栏高度，左右无额外边框，因此X轴设置看似生效，Y轴会被后续加载的标题栏高度挤出偏移。
• 接口使用不规范：Dialog内部封装的Stage是私有实现细节，JavaFX官方未对外开放该Stage的直接修改权限，不同版本、不同平台下这个内部Stage的初始化逻辑存在差异，提前修改的参数很容易被后续初始化流程覆盖。此外GNOME桌面会对新弹出的模态窗口做默认位置校正，避免窗口完全遮挡触发控件，该校正逻辑在窗口首次显示时执行，会直接覆盖提前设置的Y轴参数。

修复方案 #

无需强转Dialog内部的Stage对象，直接在DialogPane层面设置固定尺寸，等窗口完全触发shown事件（此时原生窗口初始化完成、窗口管理器的校正逻辑也执行完毕）后再设置坐标即可，全平台兼容性更好：

button.setOnAction(e -> {
    Dialog<?> d = new Dialog<>();
    // 直接在DialogPane层面固定对话框尺寸，避免依赖内部Stage实现
    d.getDialogPane().setPrefSize(600, 450);
    d.getDialogPane().setMinSize(600, 450);
    d.getDialogPane().setMaxSize(600, 450);
    // 窗口完全显示后再设置坐标，不会被初始化流程覆盖
    d.setOnShown(event -> {
        Window targetWindow = d.getDialogPane().getScene().getWindow();
        targetWindow.setX(660);
        targetWindow.setY(300);
    });
    d.showAndWait();
});

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