如何在FXML或SceneBuilder中基于屏幕尺寸设置自适应界面尺寸？

1. 无法直接在FXML中引用控制器变量 #

FXML不支持直接将控制器类中声明的windowHeight/windowWidth变量作为属性值使用，而且你代码中给普通double变量添加@FXML注解是错误的——@FXML仅用于注入FXML文件中定义的UI元素，不能标注普通成员变量。

2. 通过控制器初始化设置自适应尺寸 #

正确的做法是在控制器中注入根容器（如AnchorPane），然后在initialize方法中计算屏幕比例并设置容器尺寸：

import javafx.fxml.Initializable;
import javafx.geometry.Rectangle2D;
import javafx.scene.layout.AnchorPane;
import javafx.stage.Screen;
import java.net.URL;
import java.util.ResourceBundle;

public class Menu implements Initializable {
    @FXML
    private AnchorPane rootPane; // 注入FXML中的根AnchorPane

    @Override
    public void initialize(URL url, ResourceBundle resourceBundle) {
        Rectangle2D screenBounds = Screen.getPrimary().getBounds();
        // 设置为屏幕宽高的一半
        double windowWidth = screenBounds.getWidth() / 2;
        double windowHeight = screenBounds.getHeight() / 2;
        
        rootPane.setPrefWidth(windowWidth);
        rootPane.setPrefHeight(windowHeight);
    }
}

对应的FXML中，根AnchorPane的prefWidth/prefHeight可设为USE_COMPUTED_SIZE或直接留空。

3. 让元素随Stage缩放同步适配 #

如果希望Stage缩放时界面元素按比例变化，有两种常用实现方式：

方式一：代码绑定属性

将UI元素的尺寸绑定到根容器的尺寸比例，例如让按钮宽度始终为根面板宽度的20%：

@FXML
private Button adaptiveButton;

@Override
public void initialize(URL url, ResourceBundle resourceBundle) {
    // 绑定按钮宽度到根面板宽度的20%
    adaptiveButton.prefWidthProperty().bind(rootPane.widthProperty().multiply(0.2));
    // 绑定按钮高度到根面板高度的10%
    adaptiveButton.prefHeightProperty().bind(rootPane.heightProperty().multiply(0.1));
}

方式二：SceneBuilder中设置布局约束

无需编写代码，直接在SceneBuilder中通过布局规则实现自适应：

• AnchorPane锚点：选中元素后，在右侧Layout面板设置Top Anchor/Bottom Anchor/Left Anchor/Right Anchor，让元素边缘与容器边缘保持固定距离，元素会随容器自动拉伸。
• HBox/VBox的Hgrow/Vgrow：在HBox中选中元素，设置Hgrow为ALWAYS，元素会自动占满剩余水平空间；VBox同理设置Vgrow。
• GridPane百分比列/行：在GridPane中选中列，设置Percent Width为具体百分比（如50），列宽会按比例适配容器宽度。

4. 正确设置Stage初始尺寸 #

如果之前加载Stage时设置宽高失败，检查代码位置是否正确，正确加载示例：

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.geometry.Rectangle2D;
import javafx.scene.Scene;
import javafx.stage.Screen;
import javafx.stage.Stage;
import java.io.IOException;

public class Main extends Application {
    @Override
    public void start(Stage stage) throws IOException {
        Rectangle2D screenBounds = Screen.getPrimary().getBounds();
        double stageWidth = screenBounds.getWidth() / 2;
        double stageHeight = screenBounds.getHeight() / 2;

        FXMLLoader fxmlLoader = new FXMLLoader(Main.class.getResource("menu.fxml"));
        // 创建Scene时直接传入自适应尺寸
        Scene scene = new Scene(fxmlLoader.load(), stageWidth, stageHeight);
        
        stage.setTitle("Menu");
        stage.setScene(scene);
        stage.show();
    }

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

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