JavaFX TableView滚动条与列自动宽度调整问题求助

需求背景 #

需要实现具备以下功能的JavaFX TableView：

• 内容超出时自动显示滚动条（无需嵌套在ScrollPane中）
• 列宽根据表头（Excel第一行）自动调整（无需随后续数据变化）

当前问题：表头填充正常，但滚动条不自动出现，列宽无法自动适配表头文本。

原FXML代码 #

<Tab text="Prefill PDFs from Excel Template">
  <content>
        <TableView fx:id="tvReadExcelFile1" prefHeight="515.0" prefWidth="1004.0" />
  </content>
</Tab>

原Java填充代码 #

protected void handleOpenPrefillTemplate(ActionEvent actionEvent) throws IOException, InvalidFormatException {
int nColCount;
int nRowCount;

tvReadExcelFile1.getItems().clear();
tvReadExcelFile1.getColumns().clear();

File filePrefillTemplate = XT4FileDialog.handleOpenFileDialog("Excel File", "*.xlsx");

if (filePrefillTemplate == null) {
    Text txtNullFile = new Text("File selected is null.\n");
    tfInfo.getChildren().add(txtNullFile);
    scrollPaneInfo.setVvalue(1.0);
    return;
}

try {

    XSSFWorkbook xWorkbook = new XSSFWorkbook(filePrefillTemplate);
    XSSFSheet xSheet = xWorkbook.getSheet("info");
    XSSFSheet ySheet = xWorkbook.getSheet("data");

    nColCount = ySheet.getRow(0).getLastCellNum();
    nRowCount = ySheet.getLastRowNum();

    Row yRow = ySheet.getRow(0);

    for (int cCounter = 0; cCounter < nColCount; cCounter++) {
        Cell yCell = yRow.getCell(cCounter);
        final int finCounter = cCounter;

        final TableColumn<ObservableList, String> column = new TableColumn<>(yCell.getStringCellValue().toString());
        tvReadExcelFile1.getColumns().add(column);

        column.setCellValueFactory(new Callback<>() {
            public ObservableValue<String> call(TableColumn.CellDataFeatures<ObservableList, String> param) {
                return new SimpleStringProperty(param.getValue().get(finCounter).toString());
            }
        });
    }

    tvReadExcelFile1.setColumnResizePolicy(TableView.UNCONSTRAINED_RESIZE_POLICY);

    xWorkbook.close();

} catch (IOException ioException) {
    // IO Exception
} catch (InvalidFormatException invalidFormatException) {
    // Invalid format exception
}
}

问题修复方案 #

1. 滚动条自动显示修复 #

TableView内置滚动功能，但需要限制其最大尺寸，避免无限制扩展导致滚动条不触发。修改FXML中的TableView配置，将固定的prefHeight/prefWidth替换为maxHeight/maxWidth：

<Tab text="Prefill PDFs from Excel Template">
  <content>
        <TableView fx:id="tvReadExcelFile1" maxHeight="515.0" maxWidth="1004.0" />
  </content>
</Tab>

如果希望TableView填充Tab的整个内容区域，可设置为：

<Tab text="Prefill PDFs from Excel Template">
  <content>
        <TableView fx:id="tvReadExcelFile1" maxHeight="Infinity" maxWidth="Infinity" />
  </content>
</Tab>

2. 列宽自动适配表头修复 #

通过测量表头文本的实际宽度，手动设置列的首选宽度。修改Java代码中创建列的逻辑，添加文本宽度计算：

// 在循环创建列时添加以下代码
String headerText = yCell.getStringCellValue().toString();
final TableColumn<ObservableList, String> column = new TableColumn<>(headerText);

// 计算表头文本宽度（匹配默认表头字体）
Text text = new Text(headerText);
text.setFont(Font.font("System", FontWeight.BOLD, 12));
double textWidth = text.getLayoutBounds().getWidth();
// 加上表头左右内边距（默认约10px）
column.setPrefWidth(textWidth + 20);

完整修改后的Java代码 #

protected void handleOpenPrefillTemplate(ActionEvent actionEvent) throws IOException, InvalidFormatException {
    int nColCount;
    int nRowCount;

    tvReadExcelFile1.getItems().clear();
    tvReadExcelFile1.getColumns().clear();

    File filePrefillTemplate = XT4FileDialog.handleOpenFileDialog("Excel File", "*.xlsx");

    if (filePrefillTemplate == null) {
        Text txtNullFile = new Text("File selected is null.\n");
        tfInfo.getChildren().add(txtNullFile);
        scrollPaneInfo.setVvalue(1.0);
        return;
    }

    try {
        XSSFWorkbook xWorkbook = new XSSFWorkbook(filePrefillTemplate);
        XSSFSheet xSheet = xWorkbook.getSheet("info");
        XSSFSheet ySheet = xWorkbook.getSheet("data");

        nColCount = ySheet.getRow(0).getLastCellNum();
        nRowCount = ySheet.getLastRowNum();

        Row yRow = ySheet.getRow(0);
        // 匹配TableView表头默认字体
        Font headerFont = Font.font("System", FontWeight.BOLD, 12);

        for (int cCounter = 0; cCounter < nColCount; cCounter++) {
            Cell yCell = yRow.getCell(cCounter);
            final int finCounter = cCounter;
            String headerText = yCell.getStringCellValue().toString();

            final TableColumn<ObservableList, String> column = new TableColumn<>(headerText);
            tvReadExcelFile1.getColumns().add(column);

            // 计算并设置列首选宽度
            Text text = new Text(headerText);
            text.setFont(headerFont);
            double textWidth = text.getLayoutBounds().getWidth();
            column.setPrefWidth(textWidth + 20);

            column.setCellValueFactory(new Callback<>() {
                public ObservableValue<String> call(TableColumn.CellDataFeatures<ObservableList, String> param) {
                    return new SimpleStringProperty(param.getValue().get(finCounter).toString());
                }
            });
        }

        tvReadExcelFile1.setColumnResizePolicy(TableView.UNCONSTRAINED_RESIZE_POLICY);

        xWorkbook.close();

    } catch (IOException ioException) {
        ioException.printStackTrace();
    } catch (InvalidFormatException invalidFormatException) {
        invalidFormatException.printStackTrace();
    }
}

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