如何解决JavaFX中选择ComboBox值时GridPane列宽不一致问题

我有一个包含4列的表单：标签、控件、标签、控件。要求标签宽度未知但需始终完整显示不截断，仅让控件列宽度变化，且第1、3列（控件列）宽度相等。仅使用TextField时无问题，但添加可拉伸的ComboBox后，选择值会导致第1列宽于第3列。

问题代码 #

public class NewMain extends Application {

    enum Test { FOO, BAR }

    @Override
    public void start(Stage stage) {
        GridPane gridPane = new GridPane();
        gridPane.setHgap(10);
        gridPane.setVgap(10);
        gridPane.setPadding(new Insets(10));

        textFieldRow(gridPane, 0);
        textFieldRow(gridPane, 1);

        Label label1 = new Label("Label AAAAA BBBBB:");
        label1.setMinWidth(Region.USE_PREF_SIZE);
        var comboBox = new ComboBox<Test>();
        comboBox.setItems(FXCollections.observableArrayList(Test.values()));

        gridPane.add(label1, 0, 2);
        gridPane.add(comboBox, 1, 2);
        comboBox.setMaxWidth(Double.MAX_VALUE);

        Scene scene = new Scene(gridPane, 600, 200);
        stage.setScene(scene);
        stage.show();
    }

    private void textFieldRow(GridPane gridPane, int index) {
        Label label1 = new Label("Label AAAAA BBBBB:");
        label1.setMinWidth(Region.USE_PREF_SIZE);
        TextField textField1 = new TextField();
        GridPane.setHgrow(textField1, Priority.ALWAYS);
        textField1.setMinWidth(10);
        Label label2 = new Label("Label CCCCCC DDDDDD:");
        label2.setMinWidth(Region.USE_PREF_SIZE);
        TextField textField2 = new TextField();
        GridPane.setHgrow(textField2, Priority.ALWAYS);
        textField2.setMinWidth(10);

        gridPane.add(label1, 0, index);
        gridPane.add(textField1, 1, index);
        gridPane.add(label2, 2, index);
        gridPane.add(textField2, 3, index);
    }


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

问题根源是ComboBox选中值后，其首选宽度会随内容自动调整，进而拉动GridPane第1列的宽度。要让两个控件列宽度始终一致，需给GridPane的列设置统一约束，而非仅依赖控件的Hgrow属性。

修复步骤 #

1. 为第1、3列创建相同的ColumnConstraints，指定Hgrow为ALWAYS，确保列宽可拉伸且行为一致。
2. 给ComboBox添加Hgrow约束，强制它填充整个列宽，避免内容撑大列。

修改后的完整代码 #

public class NewMain extends Application {

    enum Test { FOO, BAR }

    @Override
    public void start(Stage stage) {
        GridPane gridPane = new GridPane();
        gridPane.setHgap(10);
        gridPane.setVgap(10);
        gridPane.setPadding(new Insets(10));

        // 定义控件列的统一约束
        ColumnConstraints controlColConstraint = new ColumnConstraints();
        controlColConstraint.setHgrow(Priority.ALWAYS);
        controlColConstraint.setMinWidth(10);

        // 给四列设置约束：标签列自适应内容，控件列共用统一约束
        gridPane.getColumnConstraints().addAll(
            new ColumnConstraints(Control.USE_COMPUTED_SIZE, Control.USE_COMPUTED_SIZE, Double.MAX_VALUE),
            controlColConstraint,
            new ColumnConstraints(Control.USE_COMPUTED_SIZE, Control.USE_COMPUTED_SIZE, Double.MAX_VALUE),
            controlColConstraint
        );

        textFieldRow(gridPane, 0);
        textFieldRow(gridPane, 1);

        Label label1 = new Label("Label AAAAA BBBBB:");
        label1.setMinWidth(Region.USE_PREF_SIZE);
        var comboBox = new ComboBox<Test>();
        comboBox.setItems(FXCollections.observableArrayList(Test.values()));

        gridPane.add(label1, 0, 2);
        gridPane.add(comboBox, 1, 2);
        comboBox.setMaxWidth(Double.MAX_VALUE);
        // 强制ComboBox填充列宽
        GridPane.setHgrow(comboBox, Priority.ALWAYS);

        Scene scene = new Scene(gridPane, 600, 200);
        stage.setScene(scene);
        stage.show();
    }

    private void textFieldRow(GridPane gridPane, int index) {
        Label label1 = new Label("Label AAAAA BBBBB:");
        label1.setMinWidth(Region.USE_PREF_SIZE);
        TextField textField1 = new TextField();
        GridPane.setHgrow(textField1, Priority.ALWAYS);
        textField1.setMinWidth(10);
        Label label2 = new Label("Label CCCCCC DDDDDD:");
        label2.setMinWidth(Region.USE_PREF_SIZE);
        TextField textField2 = new TextField();
        GridPane.setHgrow(textField2, Priority.ALWAYS);
        textField2.setMinWidth(10);

        gridPane.add(label1, 0, index);
        gridPane.add(textField1, 1, index);
        gridPane.add(label2, 2, index);
        gridPane.add(textField2, 3, index);
    }


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

核心说明 #

• 用ColumnConstraints统一管控控件列的宽度行为，确保两列始终同步。
• 给ComboBox添加GridPane.setHgrow约束，让它忽略自身内容宽度，直接填充整个列的可用空间。
• 标签列设置为自适应内容，保证标签始终完整显示不截断。

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